Identify a device

Link a registered device to a person: by phone (E.164, or national number + countryCode), by email, or by your own externalUserId. A person with a phone number is matched by phone only; without one, by email. Nobody matching → a contact is created. The alternative to contact tokens when your backend prefers one server-to-server call after login.

Authenticate with your organisation API token (Bearer). Roles: CRM_ADMIN, ACCOUNT_OWNER or CRM_BOT.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Your organisation id (the one your API token was issued for).

string
required
Body Params
Responses
401

Token missing, invalid or for another organisation

403

The token holder lacks the required role

404

Device not found in this organisation

429

Rate limited — retry after the Retry-After header

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here!