Authentication

Clarify uses OAuth and currently supports the Implicit, Authorization Code, and Refresh Token grants. We create OAuth apps for trusted partners, but allow anyone to explore the API using a test application called API Explorer for Pilots.

<aside> 💡

An OAuth access token for testing can be easily obtained using OAuth Tools: https://oauth.tools/c/968c660fa8abd0f2b2f5c6d7#THVJ1q+jArCDJlbz9k3aWLSCA7ua5sa7SAO8jwi+YX8=

</aside>

OAuth app:

Client ID 9XDjUDYzkgc9gcHaBLFLHfZmo2LBH9dd
Client Secret LGoZb-yWyMMiceQEFzLIXsxOq3UxORQqbTlljyBxSIHcjY-TrCTIvmVY6_gjarG_
Scopes openid profile email offline_access manage:entities manage:workspaces
Authorization endpoint https://auth.getclarify.ai/authorize
Token endpoint https://auth.getclarify.ai/oauth/token
The Authorization request (as a query param) and the Token request (in the body) both also need audience=clarify:service

Add the Authorization: Bearer {access-token} header to all authenticated API calls.

Root URL

https://api.getclarify.ai/v1/workspaces/{slug}/*

Slug is the workspace ID assigned to the customer’s organization. You can find it in the URL when logging in or by clicking your avatar in the application: