POST
Create a new channel

Body

application/json
name
string
required

Channel name

Minimum string length: 1
platform
enum<string>
required

Platform type

Available options:
whatsapp_official,
whatsapp_unofficial,
instagram,
messenger,
telegram,
sms
config
any

Provider-specific configuration

metadata
any

Arbitrary metadata

mode
enum<string>
default:single

Channel mode

Available options:
single,
hybrid
phone
string

Phone number

Response

Created

created_at
string
required
id
string
required
is_active
boolean
required
last_connected_at
string | null
required
last_error
string | null
required
linked_channel_id
string | null
required
metadata
any
required
mode
string
required
name
string
required
organization_id
string
required
phone_number
string | null
required
platform
string
required
status
string
required
updated_at
string
required
config
any
health_state
string

Operator-facing health: healthy, auth_required, degraded, setup_required

last_failure_class
string

auth, payload, operational (support)

operator_message
string

Safe message for workspace UI; never raw Meta errors