Documentation contents

Integration guide

Authentication and API keys

Each key grants access to one business and the locations and scopes selected in the cabinet. Send requests from your integration server over HTTPS.

  1. Verify the owner’s email address before creating or rotating an API key.
  2. Open Administration → Integrations → API keys in the cabinet.
  3. Choose a name, authorized locations and the scopes your integration needs.
  4. Keep “No expiry”, or select an optional term of 1–365 days.
  5. Copy the secret shown once and store it in your secret manager or the server environment variable MEREU_API_KEY.
OperationWhat happens
Create without a deadlineThe key does not expire automatically; expiresAt=null.
RotateThe previous key is revoked immediately. Update the key on your integration server.
RevokeThe connection stays revoked. Create a new connection to restore access.
Lost creation responseReload the list and rotate the key. Repeating the request never reveals the secret.

An expired key can be rotated in the cabinet. Indefinite keys need no scheduled renewal. An expired sync cursor does not mean the API key expired.