Skip to main content

Authentication

Exotel uses HTTP Basic Authentication for all Voice API endpoints. The same credentials work for both Voice v1 and Voice v2 (CCM) APIs.

Credentials​

CredentialDescription
API KeyYour username for HTTP Basic Auth
API TokenYour password for HTTP Basic Auth
Account SIDYour account identifier used in URL paths

All credentials are available on your Exotel Dashboard under Settings > API Settings.

Base URLs​

Voice v1 (Standard)​

https://<api_key>:<api_token>@<subdomain>/v1/Accounts/<account_sid>/
RegionSubdomain
Singaporeapi.exotel.com
Mumbaiapi.in.exotel.com

Voice v2 (CCM)​

https://<api_key>:<api_token>@<ccm_subdomain>/v2/accounts/<account_sid>/
RegionCCM Subdomain
Singaporeccm-api.exotel.com
Mumbaiccm-api.in.exotel.com

Making Authenticated Requests​

Using URL credentials​

# Voice v1
curl https://your_api_key:your_api_token@api.exotel.com/v1/Accounts/your_sid/Calls.json

# Voice v2 (CCM)
curl https://your_api_key:your_api_token@ccm-api.exotel.com/v2/accounts/your_sid/calls

Using Authorization header​

# Base64 encode "api_key:api_token"
curl -H 'Authorization: Basic <base64_encoded_credentials>' \
https://ccm-api.exotel.com/v2/accounts/your_sid/calls

Don't Have Credentials?​

If you don't have an Exotel account yet, create one here.