API Documentation

Secure your apps with standards-compliant authentication and authorization. Use our OIDC/OAuth 2.0 endpoints to sign in users, manage profiles, issue access tokens, and protect APIs with roles, permissions, and scopes.

Getting started

  • Create an application in the developer console and register redirect and post-logout redirect URIs.
  • Choose a flow:
  • Authorization Code + PKCE for user sign-in.
  • Client Credentials for service-to-service.
  • Use the discovery document at /.well-known/openid-configuration to locate authorization_endpoint, token_endpoint, userinfo_endpoint, and jwks_uri.
  • Request scopes like openid, profile, email, and offline_access as needed.
  • Validate ID tokens (iss, aud, exp, nonce) and use access tokens to authorize API calls.

Guides

Authentication

Learn how to authenticate your API requests.

Read more

Pagination

Understand how to work with paginated responses.

Read more

Errors

Read about the different types of errors returned by the API.

Read more

Webhooks

Learn how to programmatically configure webhooks for your app.

Read more

Resources

Contacts

Learn about the contact model and how to create, retrieve, update, delete, and list contacts.

Conversations

Learn about the conversation model and how to create, retrieve, update, delete, and list conversations.

Messages

Learn about the message model and how to create, retrieve, update, delete, and list messages.

Groups

Learn about the group model and how to create, retrieve, update, delete, and list groups.

Was this page helpful?