Skip to main content
POST
/
api
/
v1
/
channels
/
twilio
/
Create Twilio Channel
curl --request POST \
  --url https://api.syllable.cloud/api/v1/channels/twilio/ \
  --header 'Content-Type: application/json' \
  --header 'Syllable-API-Key: <api-key>' \
  --data '{
  "name": "syllable-webchat",
  "config": {
    "account_sid": "AC123...",
    "auth_token": "sometoken"
  }
}'
{
  "name": "syllable-webchat",
  "channel_service": "webchat",
  "supported_modes": "chat,voice",
  "is_system_channel": false,
  "id": 123,
  "config": {
    "telephony": {
      "interruptibility": "dtmf_only",
      "overall_input_timeout": 20,
      "passive_input_start": 0.5,
      "passive_speech_input_enabled": true,
      "pre_input_timeout": 1.2
    }
  }
}

Authorizations

​
Syllable-API-Key
string
header
required

Body

application/json

Request model for creating a Twilio channel.

​
name
string
required

The channel name

Examples:

"syllable-webchat"

​
config
object
required

The configuration of the channel

Response

Successful Response

​
name
string
required

The channel name

Examples:

"syllable-webchat"

​
channel_service
enum<string>
required

The service that facilitates communication on the channel

Available options:
sip,
twilio,
email,
webchat,
africastalking
​
id
integer
required

The channel ID

​
supported_modes
string | null

The comma-delimited list of supported modes for the channel, which defines the possible communication methods for channel targets linked to it.

Examples:

"chat,voice"

​
is_system_channel
boolean
default:true

Whether the channel is a built-in system channel (i.e., is not customizable)

Examples:

false

​
config
object | null

Configuration for the channel

Examples:
{
  "telephony": {
    "interruptibility": "dtmf_only",
    "overall_input_timeout": 20,
    "passive_input_start": 0.5,
    "passive_speech_input_enabled": true,
    "pre_input_timeout": 1.2
  }
}