Create a new channel

Create a new channel. A maximum of 100 channels can be created per account per day. The maximum request size is 10MB.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
descriptionstringRequired
A description of the channel
modalityenumRequired
The modality of the channel
Allowed values:
namestringRequired
The name of the channel
metadatamap from strings to strings or booleans or integersOptional

A dictionary of key, value pairs assigned to the channel. Metadata may not exceed 4KB total

  • metadata keys may only be of type: string
  • metadata values may only be one of type: string, boolean, or integer

Response

Channel created
descriptionstring
A description of the channel
modalityenum
The modality of the channel
Allowed values:
namestring
The name of the channel
created_atstring or nullformat: "date-time"
The date and time the channel was created
idstring or nullformat: "id"
The channel ID
metadatamap from strings to strings or booleans or integers or null

A dictionary of key, value pairs assigned to the channel. Metadata may not exceed 4KB total

  • metadata keys may only be of type: string
  • metadata values may only be one of type: string, boolean, or integer
typeenum or null
The type of the channel
Allowed values:

Errors