Create credentials (digest auth) API for a Trunk

9 min

1. Create credentials (SIP digest)

Creates a username/password pair for SIP Digest authentication on the trunk. Configure the same values on your Voice AI platform’s SIP trunk settings.

HTTP Request

POST https://<API_KEY>:<API_TOKEN>@<SUBDOMAIN>/v2/accounts/<ACCOUNT_SID>/trunks/<TRUNK_SID>/credentials

Request Headers

Header	Value
Content-Type	application/json

Request Parameters

The following parameters are sent as JSON in the body of the request:

Parameter Name	Mandatory/Optional	Value
user_name	Mandatory	String; SIP digest username. Example: voice_ai_user
password	Mandatory	String; SIP digest password. Use a strong secret.
friendly_name	Optional	String; Label to identify where the creds are used (max 32 chars). Example: elevenlabs-prod, livekit-staging

Example Request

curl -s -X POST "https://<API_KEY>:<API_TOKEN>@<SUBDOMAIN>/v2/accounts/<ACCOUNT_SID>/trunks/<TRUNK_SID>/credentials" \ -H "Content-Type: application/json" \ -d '{ "user_name": "voice_ai_user", "password": "REPLACE_WITH_STRONG_PASSWORD", "friendly_name": "voice_ai_platform" }'

HTTP Response

On success, the HTTP response status code will be 200 OK.

Example Response

{ "request_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "method": "POST", "http_code": 200, "response": { "code": 200, "error_data": null, "status": "success", "data": { "id": "1234", "trunk_sid": "trmum17d8e9a37a3732ecbf91a3u", "user_name": "voice_ai_user", "friendly_name": "voice_ai_platform", "date_created": "2026-01-23T11:37:36Z", "date_updated": "2026-01-23T11:37:36Z" } } }

Response Parameters

Parameter Name	Type & Value
request_id	String; Unique identifier for this API request
method	String; HTTP method used (POST)
http_code	Integer; HTTP status code (200 for success)
id	String; Unique identifier for this credential entry. Example: 1234
trunk_sid	String; The trunk these credentials are associated with
user_name	String; The SIP digest username you set
friendly_name	String or null; Optional label
date_created	String; ISO 8601 timestamp when credentials were created
date_updated	String; ISO 8601 timestamp when credentials were last updated

2. List credentials (verify)

Lists credentials configured for the trunk.

HTTP Request

GET https://<API_KEY>:<API_TOKEN>@<SUBDOMAIN>/v2/accounts/<ACCOUNT_SID>/trunks/<TRUNK_SID>/credentials

Example Request

curl -s "https://<API_KEY>:<API_TOKEN>@<SUBDOMAIN>/v2/accounts/<ACCOUNT_SID>/trunks/<TRUNK_SID>/credentials"

HTTP Response

On success, the HTTP response status code will be 200 OK.

Example Response

{ "request_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "method": "GET", "http_code": 200, "metadata": { "total": 1, "page_size": 50, "page": 1, "first_page_uri": "/v2/accounts/exotelveenotesting1m/trunks/trmum17d8e9a37a3732ecbf91a3u/credentials?page_size=50&offset=0", "prev_page_uri": null, "next_page_uri": null }, "response": [ { "code": 200, "error_data": null, "status": "success", "data": { "id": "1234", "trunk_sid": "trmum17d8e9a37a3732ecbf91a3u", "user_name": "voice_ai_user", "friendly_name": "voice_ai_platform", "date_created": "2026-01-23T11:37:36Z", "date_updated": "2026-01-23T11:37:36Z" } } ] }

Response Parameters

Parameter Name	Type & Value
request_id	String; Unique identifier for this API request
method	String; HTTP method used (GET)
http_code	Integer; HTTP status code (200 for success)
metadata.total	Integer; Total credential records available
metadata.page_size	Integer; Page size applied
metadata.page	Integer; Page number (if present)
metadata.first_page_uri	String; URI for first page
metadata.prev_page_uri	String or null; URI for previous page
metadata.next_page_uri	String or null; URI for next page
response	Array; List of credential objects
response[].data.id	String; Unique identifier for the credential entry
response[].data.trunk_sid	String; The trunk these credentials are associated with
response[].data.user_name	String; SIP digest username
response[].data.friendly_name	String or null; Optional label
response[].data.date_created	String; ISO 8601 timestamp when created
response[].data.date_updated	String; ISO 8601 timestamp when updated

3. Delete credentials (rotate / revoke)

Deletes a credential entry when rotating credentials or removing access for a provider environment.

HTTP Request

DELETE https://<API_KEY>:<API_TOKEN>@<SUBDOMAIN>/v2/accounts/<ACCOUNT_SID>/trunks/<TRUNK_SID>/credentials?id=<CREDENTIAL_ID>

Important: credential id is passed as query param id (not /credentials/<CREDENTIAL_ID>).

Example Request

curl -s -X DELETE "https://<API_KEY>:<API_TOKEN>@<SUBDOMAIN>/v2/accounts/<ACCOUNT_SID>/trunks/<TRUNK_SID>/credentials?id=<CREDENTIAL_ID>"

HTTP Response

On success, the HTTP response status code will be 200 OK.

Example Response

{ "request_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "method": "DELETE", "http_code": 200, "response": { "code": 200, "error_data": null, "status": "success", "data": { "id": "1234", "trunk_sid": "trmum17d8e9a37a3732ecbf91a3u", "user_name": "voice_ai_user", "friendly_name": "voice_ai_platform", "date_created": "2026-01-23T11:37:36Z", "date_updated": "2026-01-23T11:37:36Z" } } }

Response Parameters

Parameter Name	Type & Value
request_id	String; Unique identifier for this API request
method	String; HTTP method used (DELETE)
http_code	Integer; HTTP status code (200 for success)
id	String; Deleted credential identifier
trunk_sid	String; Trunk SID this credential belonged to
user_name	String; SIP digest username that was deleted
friendly_name	String or null; Optional label
date_created	String; ISO 8601 timestamp when credential was originally created
date_updated	String; ISO 8601 timestamp when credential was last updated