---
title: "Update a custom channel"
method: PATCH
path: "/conversations/v3/custom-channels/{channelId}"
tags: ["Channels"]
---

# Update a custom channel

`PATCH /conversations/v3/custom-channels/{channelId}`

Update the capabilities for an existing. You can also use it to update the channel's webhookUri and its channelAccountConnectionRedirectUrl.

## Path parameters

- `channelId` integer, required

## Request body

- PublicChannelIntegrationChannelPatch
  - `capabilities` object, required
  - `channelAccountConnectionRedirectUrl` object, required
  - `channelDescription` object, required
  - `channelLogoUrl` object, required
  - `name` object, required
  - `webhookUrl` object, required

## Response `200`

successful operation

- PublicChannelIntegrationChannel
  - `capabilities` object, required
  - `channelAccountConnectionRedirectUrl` string
  - `channelDescription` string
  - `channelLogoUrl` string
  - `createdAt` string, date-time, required
  - `id` string, required
  - `name` string, required
  - `webhookUrl` string

## Other responses

- `default` — An error occurred.

## Changes

- **2026-09-22** (v3) `8a1b3ec14bc8` — 1 info
  - the endpoint scheme security `developer_hapikey` was added to the API
- **2026-07-13** (v3) `5cdcacfbfd17` — 1 info
  - endpoint added
- **2026-07-13** (v3) `00e6adb0221a` — 1 breaking
  - api path removed without deprecation
- **2026-06-15** (v3) `a33b64c122e1` — 1 breaking
  - the `id` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `200`
- **2026-06-15** (v3) `d2964f62ab13` — 1 breaking
  - the `id` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `200`

[Full history](https://skmtc.dev/hubspot/apis/conversations-custom-channels/changes/conversations/v3/custom-channels/:channelId/patch.md)

---

[API](https://skmtc.dev/hubspot/apis/conversations-custom-channels.md) · [All operations](https://skmtc.dev/hubspot/apis/conversations-custom-channels/llms.txt) · [OpenAPI document](https://skmtc.dev/hubspot/apis/conversations-custom-channels/revisions/8a1b3ec14bc8?raw)