Clarify APIAuthentication
API keys for direct integrations and OAuth 2.0 for partners
Clarify supports two authentication methods: API keys for your own integrations, and OAuth 2.0 for partner applications acting on behalf of other workspaces.
API keys
Create an API key in Settings → API Keys
(workspace admins only). Send it in
the Authorization header using the api-key scheme — note that this is not
a Bearer token:
Authorization: api-key YOUR_API_KEYA complete request:
curl https://api.clarify.ai/v1/workspaces/your-workspace/objects/person/records \
-H "Authorization: api-key YOUR_API_KEY"An API key carries full access to its workspace. Store it in an environment variable, never commit it to source control, and rotate keys periodically.
OAuth 2.0
Partner integrations that act on behalf of Clarify users authenticate with
OAuth 2.0 using the Authorization Code flow with PKCE. OAuth tokens use
the standard Bearer scheme:
Authorization: Bearer ACCESS_TOKENEndpoints live at auth1.clarify.ai. Supported scopes:
openidprofileemailoffline_access— request this to receive a refresh token
Contact support@clarify.ai to register an OAuth client.