Skip to main content
PATCH
/
conversations
/
v3
/
custom-channels
/
{channelId}
Update a custom channel
curl --request PATCH \
  --url 'https://api.hubapi.com/conversations/v3/custom-channels/{channelId}?hapikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "capabilities": {},
  "channelAccountConnectionRedirectUrl": {},
  "channelDescription": {},
  "channelLogoUrl": {},
  "name": {},
  "webhookUrl": {}
}
'
{
  "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

Path Parameters

channelId
integer<int32>
required

The ID of the channel to update.

Body

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

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