Skip to main content
POST
/
conversations
/
v3
/
custom-channels
Create a custom channel
curl --request POST \
  --url 'https://api.hubapi.com/conversations/v3/custom-channels/?hapikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "capabilities": {},
  "name": "<string>",
  "channelAccountConnectionRedirectUrl": "<string>",
  "channelDescription": "<string>",
  "channelLogoUrl": "<string>",
  "webhookUrl": "<string>"
}
'
{
  "capabilities": {},
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "name": "<string>",
  "channelAccountConnectionRedirectUrl": "<string>",
  "channelDescription": "<string>",
  "channelLogoUrl": "<string>",
  "webhookUrl": "<string>"
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Professional
Service HubService Hub -Professional
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

hapikey
string
query
required

Body

application/json
capabilities
object
required
name
string
required
channelAccountConnectionRedirectUrl
string
channelDescription
string
channelLogoUrl
string
webhookUrl
string

Response

successful operation

capabilities
object
required
createdAt
string<date-time>
required
id
string
required
name
string
required
channelAccountConnectionRedirectUrl
string
channelDescription
string
channelLogoUrl
string
webhookUrl
string
Last modified on December 16, 2025