curl -X POST "https://app.talkover.ai/api/v1/sip-trunks/trunk-uuid-1/dids" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"country_code": "US",
"number": "+15551234567"
}'
{
"success": true,
"data": {
"id": "phone-uuid-1",
"number": "+15551234567",
"country_code": "US",
"formatted_number": "(555) 123-4567",
"trunk_id": "trunk-uuid-1"
}
}
Custom SIP Trunks
Create SIP Trunk DID
Add a DID (phone number) to a SIP trunk
POST
/
api
/
v1
/
sip-trunks
/
{trunk_id}
/
dids
curl -X POST "https://app.talkover.ai/api/v1/sip-trunks/trunk-uuid-1/dids" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"country_code": "US",
"number": "+15551234567"
}'
{
"success": true,
"data": {
"id": "phone-uuid-1",
"number": "+15551234567",
"country_code": "US",
"formatted_number": "(555) 123-4567",
"trunk_id": "trunk-uuid-1"
}
}
Create SIP Trunk DID
Register a new DID (phone number) on a SIP trunk. Once added, the DID can be assigned to agents for inbound or outbound calling.Endpoint
POST /api/v1/sip-trunks/{trunk_id}/dids
Path parameters
string
required
SIP trunk UUID.
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_herestring
required
Must be set to
application/jsonRequest body
string
required
ISO 3166-1 alpha-2 country code (e.g.,
US, BR, GB).string
required
Phone number in E.164 format (e.g.,
+15551234567).Examples
curl -X POST "https://app.talkover.ai/api/v1/sip-trunks/trunk-uuid-1/dids" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"country_code": "US",
"number": "+15551234567"
}'
Response
{
"success": true,
"data": {
"id": "phone-uuid-1",
"number": "+15551234567",
"country_code": "US",
"formatted_number": "(555) 123-4567",
"trunk_id": "trunk-uuid-1"
}
}
Error responses
409 — Number Already Exists
{
"success": false,
"message": "This number is already registered in your environment",
"code": "DID_ALREADY_EXISTS"
}
Was this page helpful?