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

# Get a custom channel

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

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/conversations/v3/custom-channels/{channelId}`
- Auth: API key in query parameter `hapikey`

Retrieve the details about a custom channel. This API allows you to see a custom channel's current capabilties and other configuration metadata

## Path parameters

- `channelId` integer, 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`

[Operation history](https://skmtc.dev/hubspot/apis/conversations-custom-channels/changes/conversations/v3/custom-channels/:channelId/get.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/b6d4942824fa?raw)
