Developers
Authentication
Bearer tokens for the agent site API — create, copy anytime, and revoke from Integrations.
Bearer tokens
Authenticate every request with an API key:
Authorization: Bearer ume_<prefix>_<secret>
Tokens look like ume_ab12_…. They are unique secrets stored so you can open API Access later and copy them again — not a one-time reveal.
Create and copy
- Open the agent dashboard on the site you want to write to.
- Go to Website → Integrations.
- Open API Access.
- Create a token (give it a label like “Zapier”).
- Copy the full token whenever you need it — it stays visible in the portal until you revoke it.
The member who creates the key is used as the default assignee / createdBy for clients inserted with that key.
Revoke
Revoking a key immediately rejects further requests with that Bearer value. Existing clients already created are not deleted.
Errors
| Status | Meaning |
|---|---|
401 | Missing, unknown, or revoked Bearer token |
403 | Key cannot access the site (e.g. site missing) |