Connect a workspace Twilio number to a voice agent

Rechecks the preview before importing and assigning. SMS stays disabled in the voice engine and existing SMS routing is checked. Records original routing before first import; uncertain creates are not repeated automatically. Owner/admin required.

POST

https://api.channelautomation.com/api/voice-workspace-numbers/connect

Authorization

BearerAuth
HTTP Bearer (JWT)
required

Header parameters

x-workspace-id
string
required

Request body JSON required

sid
string
required
assistantId
string
required
format: uuid
routingVersion
string
required
confirmVoiceRouting
true
required
name
optional
string
maxLength: 100

Returns

200

Number imported; connected=false and warning indicate partial success requiring attention

JSON

success
optional
boolean
number
optional
object
- id
  optional
  string
- number
  optional
  string
- connected
  optional
  boolean
- warning
  optional
  string
}

400

Invalid input or confirmation missing

401

403

Workspace access or feature disabled

404

Number not in workspace

409

Routing changed or earlier import requires reconciliation

412

Integration configuration required

500

Unexpected error

502

Provider rejected request; refresh before retrying

503

Provider outcome or configuration unavailable

Connect a workspace Twilio number to a voice agent

curl --request POST \
  --url https://api.channelautomation.com/api/voice-workspace-numbers/connect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-workspace-id: string' \
  --data '
{
  "sid": "string",
  "assistantId": "bb8c7fe3-2157-48a3-a0a7-af503b091988",
  "routingVersion": "string",
  "confirmVoiceRouting": true,
  "name": "string"
}
'

const url = 'https://api.channelautomation.com/api/voice-workspace-numbers/connect';
const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-workspace-id': 'string',
    Authorization: 'Bearer <token>'
  },
  body: JSON.stringify({
    sid: 'string',
    assistantId: 'bb8c7fe3-2157-48a3-a0a7-af503b091988',
    routingVersion: 'string',
    confirmVoiceRouting: true,
    name: 'string'
  })
};

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/voice-workspace-numbers/connect"

payload = {
    "sid": "string",
    "assistantId": "bb8c7fe3-2157-48a3-a0a7-af503b091988",
    "routingVersion": "string",
    "confirmVoiceRouting": True,
    "name": "string"
}
headers = {
    "Content-Type": "application/json",
    "x-workspace-id": "string",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

Response example

{
  "success": true,
  "number": {
    "id": "string",
    "number": "string",
    "connected": true,
    "warning": "string"
  }
}