Skip to main content

API Tokens

Causely provides two types of API tokens depending on the scope of access needed: Personal Tokens scoped to an individual user, and Tenant-wide Tokens shared across the workspace.

Personal Tokens​

Personal tokens are tied to your individual account and carry your user's permissions.

To create a personal token:

  1. Open the Admin Portal (profile icon → Admin Portal)
  2. Select Personal Tokens from the left sidebar
  3. Click Create Token
  4. Give the token a descriptive name and set its expiration
  5. Copy and securely store the token value—it will not be shown again

Tenant-wide Tokens​

Tenant-wide tokens are not tied to an individual user and can be used for workspace-level integrations and automation. Only Administrators can create and manage tenant-wide tokens.

To create a tenant-wide token:

  1. Open the Admin Portal (profile icon → Admin Portal)
  2. Select API Tokens from the left sidebar
  3. Click Create Token
  4. Give the token a descriptive name and set its expiration
  5. Copy and securely store the token value—it will not be shown again

Using Your Token​

Once you have a token, see API Authentication for how to authenticate requests to the Causely API.

Token Security​

  • Treat tokens like passwords—store them in a secrets manager and never commit them to source control
  • Set expiration dates when creating tokens
  • Delete tokens that are no longer in use
  • For mediator token rotation and revocation, see Token Management and Developer Role