Skip to main content

Bearer token

All API requests require a Bearer token in the Authorization header.
curl https://api.247calldesk.com/api/v1/voice/calls \
  -H "Authorization: Bearer calldesk_your_api_key_here"

Getting your API key

API keys are provisioned when your account is set up. Each key is prefixed with calldesk_ and should be kept secret.
API keys are hashed before storage. If you lose your key, you will need to generate a new one.

Key format

ComponentExample
Prefixcalldesk_
Tokena1b2c3d4e5f6... (32 hex characters)
Full keycalldesk_a1b2c3d4e5f6...

Security best practices

  • Store API keys in environment variables, never in source code
  • Rotate keys periodically
  • Use separate keys for development and production
  • Monitor key usage via the account endpoint