Skip to main content

Authorization

Follow this guide to create a new Chorus.ai credential that will allow Nexla to authenticate to and exchange data with your Chorus.ai account.
chorus_ai_api_auth.png

Chorus.ai

Prerequisites​

The Chorus.ai API authenticates each request with a personal API token that is generated from within the Chorus.ai application. Before creating a credential in Nexla, generate an API token and confirm that your Chorus.ai role is permitted to access the API.

Account and Role Requirements​

Chorus.ai is part of ZoomInfo. To generate and use an API token, the following requirements must be met:

  • You must have an active Chorus.ai account with sign-in access to your organization's Chorus.ai portal.

  • Your Chorus.ai role must be permitted to access the Chorus API. API access is controlled through your organization's roles and permissions settings, and generating a token typically requires administrator-level permissions. A Chorus.ai administrator can enable API access for your role if it is not already permitted.

API tokens are issued per user, and each token inherits the data access of the user who created it. Generate the token from a user account whose visibility covers all of the conversations, teams, and analytics you intend to ingest into Nexla.

Generate a Chorus.ai API Token​

  1. Sign in to your Chorus.ai portal at https://chorus.ai.

  2. Navigate to Settings > Personal Settings.

  3. Locate the API Access section on the Personal Settings page.

  4. Click Generate API Token to create a new token.

  5. Copy the generated token immediately and store it securely.

    Important

    The API token is displayed only once at the time of generation and cannot be viewed again. If the token is lost, you must deactivate the existing token and generate a new one.

For complete information about the Chorus.ai API and token management, refer to the Chorus API documentation.

Create a Chorus.ai Credential​

  • To create a new Chorus.ai credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Token​

Chorus.ai uses a single authentication method: a personal API token that Nexla sends in the Authorization request header on every API call. Unlike many APIs, Chorus.ai expects the raw token value with no Bearer prefix.

  1. Enter the API token generated from your Chorus.ai Personal Settings page in the API Token field. This token authenticates Nexla with the Chorus.ai API and grants access to the conversations, engagements, users, and analytics that the issuing user can view.

    The API token is a secret credential. It is stored securely by Nexla and is masked after entry. Treat it like a password, and rotate it from your Chorus.ai Personal Settings page if it is ever exposed.

    Nexla validates the credential against the Chorus.ai https://chorus.ai/api/v1/me endpoint when it is saved, confirming that the token is valid and that the authenticated user can be retrieved.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.