Route a Twilio voice call to the configured workspace destination

Twilio form webhook. Workspaces with VOICE_AI_TELEPHONY_TURN_CONTROL_V2 require X-Twilio-Signature validation before call routing; the new AI path emits a short-lived signed stream permission. Uses the exact public webhook URL including query parameters. New outbound callbacks with voiceLease also require the Twilio signature and bind the pre-dial capacity lease atomically. Legacy inbound routing is unchanged.

POST

https://api.channelautomation.com/api/workspaces/{workspaceId}/voice

Path parameters

workspaceId
string
required

Query parameters

voiceLease
optional
string
Internal provisional outbound capacity lease; requires a valid Twilio signature.

Header parameters

X-Twilio-Signature
optional
string
Required for the new voice path; Twilio signs the URL and form body.

format: uuid

Request body X-WWW-FORM-URLENCODED required

CallSid
optional
string
Direction
optional
string
From
optional
string
To
optional
string

Returns

200

TwiML routing instructions

400

Invalid workspace or request

401

Workspace configuration unavailable

403

Invalid Twilio signature

404

Workspace not found

500

Routing failed

Route a Twilio voice call to the configured workspace destination

curl --request POST \
  --url 'https://api.channelautomation.com/api/workspaces/<workspaceId>/voice' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode CallSid=string \
  --data-urlencode Direction=string \
  --data-urlencode From=string \
  --data-urlencode To=string

const encodedParams = new URLSearchParams();
encodedParams.append('CallSid', 'string');
encodedParams.append('Direction', 'string');
encodedParams.append('From', 'string');
encodedParams.append('To', 'string');

const url = 'https://api.channelautomation.com/api/workspaces/<workspaceId>/voice';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/x-www-form-urlencoded'},
  body: encodedParams
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/workspaces/<workspaceId>/voice"

payload = {
    "CallSid": "string",
    "Direction": "string",
    "From": "string",
    "To": "string"
}
headers = {"Content-Type": "application/x-www-form-urlencoded"}

response = requests.post(url, data=payload, headers=headers)

print(response.text)