Create a new channel

import requests
url = "https://example.ada.support/api/v2/channels/"
payload = {
    "description": "A custom messaging channel for my AI Agent",
    "modality": "messaging",
    "name": "My Custom Channel"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "description": "A custom messaging channel for my AI Agent",
  "modality": "messaging",
  "name": "My Custom Channel",
  "created_at": "2020-09-20T00:00:00+00:00",
  "id": "5df263b7db5a7e6ea03fae9b",
  "metadata": {
    "example_key1": "example_string_value",
    "example_key2": true,
    "example_key3": 123,
    "example_key4": 0.95
  },
  "type": "custom"
}

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

import requests
url = "https://example.ada.support/api/v2/channels/"
payload = {
    "description": "A custom messaging channel for my AI Agent",
    "modality": "messaging",
    "name": "My Custom Channel"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "description": "A custom messaging channel for my AI Agent",
  "modality": "messaging",
  "name": "My Custom Channel",
  "created_at": "2020-09-20T00:00:00+00:00",
  "id": "5df263b7db5a7e6ea03fae9b",
  "metadata": {
    "example_key1": "example_string_value",
    "example_key2": true,
    "example_key3": 123,
    "example_key4": 0.95
  },
  "type": "custom"
}

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

Authentication

AuthorizationBearer

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 integers or doublesOptional

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, integer, or number (float)

Response

Channel created

descriptionstring

A description of the channel

modalityenum

The modality of the channel

Allowed values:

namestring

The name of the channel

created_atstringRead-onlyformat: "date-time"

The date and time the channel was created

idstringRead-onlyformat: "id"

The channel ID

metadatamap from strings to strings or booleans or integers or doubles

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, integer, or number (float)

typeenumRead-only

The type of the channel

Allowed values:

Errors

400

Bad Request Error

401

Unauthorized Error

413

Content Too Large Error

429

Too Many Requests Error

500

Internal Server Error

1	import requests
2
3	url = "https://example.ada.support/api/v2/channels/"
4
5	payload = {
6	"description": "A custom messaging channel for my AI Agent",
7	"modality": "messaging",
8	"name": "My Custom Channel"
9	}
10	headers = {
11	"Authorization": "Bearer <token>",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.post(url, json=payload, headers=headers)
16
17	print(response.json())

1	{
2	"description": "A custom messaging channel for my AI Agent",
3	"modality": "messaging",
4	"name": "My Custom Channel",
5	"created_at": "2020-09-20T00:00:00+00:00",
6	"id": "5df263b7db5a7e6ea03fae9b",
7	"metadata": {
8	"example_key1": "example_string_value",
9	"example_key2": true,
10	"example_key3": 123,
11	"example_key4": 0.95
12	},
13	"type": "custom"
14	}