Skip to main content
Each TalkChief integration uses its own credential. Your company has one 64-character Click-to-Call key and one 64-character AI Transcriber key. Because the keys are separate, you can rotate one without affecting the other. The CDR webhook works the other way around: TalkChief calls your endpoint, and you choose the credential it sends.
None of these APIs use Authorization: Bearer with a TalkChief key. Bearer and basic auth only apply to webhook deliveries that TalkChief sends to your endpoint.

Generate a key

1

Open the API keys

Sign in as a company admin and go to Integrations → API → Overview & keys. Under API Keys there’s one panel for Click-to-Call and one for AI Transcriber.
2

Generate the key

If a panel says No key generated yet., click Generate key. Once the key exists, the panel shows Active.
3

Copy the key

Click Show key to reveal it, or click Copy to copy it. You can come back to this page any time to view the key again.
4

Note your Company ID (transcription only)

The Company ID appears at the top of Integrations → API → Overview & keys. Send it as company_id with AI Transcription requests.
Integrations > API > Overview & keys with the Company ID, base URL and the Click-to-Call and AI Transcriber key panels

Send the key

If you send api_key in the body and the X-API-Key header together, Click-to-Call uses the body value.

What happens when a key is wrong

The two APIs report key problems differently. Click-to-Call answers successful calls and the errors above with HTTP 200, so check success and error_code in the response body. A request that goes over the rate limit is rejected with HTTP 429 before it is processed, so check the HTTP status first. See REST API conventions for both response formats.

Rotate a key

1

Start the rotation

In Integrations → API → Overview & keys, click Rotate key on the panel you want to rotate.
2

Confirm

The dialog warns that the current key stops working immediately. Click Confirm rotation.
3

Update your integration

Copy the new key into your backend configuration and reload it. Requests that still use the old key fail right away.
Rotation takes effect immediately and there’s no grace period. Schedule it at a time when you can deploy the new key straight away.
You can’t delete a key from the app. To revoke a leaked key, rotate it.

Security practices

  • Keep keys on your server. Never put them in browser JavaScript, mobile apps or public repositories.
  • Store keys in environment variables or a secrets manager.
  • If you think a key has leaked, rotate it right away.
  • For the CDR webhook, use HTTPS and turn on one of the authentication options. Your endpoint can then reject requests that don’t come from TalkChief. See CDR webhook.