User provisioning (SCIM 2.0)
AthenaHQ exposes a SCIM 2.0 endpoint for automated user provisioning and deprovisioning from your identity provider:- Base URL:
https://app.athenahq.ai/api/scim/v2 - Authentication: OAuth bearer token. Generate the token from Settings → General in the AthenaHQ dashboard.
- Supported operations: user create, read, update (PUT and PATCH), and deprovision. Filter is supported (max 100 results per page).
- Out of scope today: group provisioning, bulk operations, and sort are not implemented. AthenaHQ does not use passwords, so SCIM password change is not applicable. If you need any of the unsupported operations, mention it when you contact support.
Request setup
To enable SSO for your organization, email support@athenahq.ai with:- Your AthenaHQ organization name
- The identity provider you want to connect and the protocol you plan to use (SAML or OIDC)
- The email domain(s) your users sign in with
- A primary technical contact for the rollout
- SAML connections: ACS URL, entity ID, and signing certificate so you can register AthenaHQ as a service provider in your IdP. You then send back your IdP’s SAML metadata (or sign-in URL + signing certificate).
- OIDC connections: the redirect URI and required scopes so you can create an OIDC client in your IdP. You then send back the
client_idandclient_secretissued by your IdP.
Contact support
Email support@athenahq.ai to start SSO onboarding
SSO is an Enterprise-tier feature. If you are not on an Enterprise plan, contact your AthenaHQ account team about upgrading.