# HubSpot Conversations Custom Channels API

> HubSpot Conversations Custom Channels API on Apizie: 13 endpoints (List Channels, Create, Get a custom channel, Update a custom channel, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/business:hubspot-conversations-custom-channels/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `business:hubspot-conversations-custom-channels`
- Category: Business
- Status: byok
- Source: https://developers.hubspot.com/docs/api/overview
- Page: https://apizie.tech/api/business/hubspot-conversations-custom-channels
- OpenAPI: https://apizie.tech/api/business/hubspot-conversations-custom-channels/openapi.json

Basepom for all HubSpot Projects

## Endpoints

### List Channels
`GET https://apizie.tech/v1/business:hubspot-conversations-custom-channels/get-conversations-custom-channels-2026-09-conversations-cust` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| after | string | no | The paging cursor token of the last successfully read resource will be returned as the `paging.next.after` JSON property of a paged… |
| defaultPageLength | integer | no | The default number of results to display per page. |
| limit | integer | no | The maximum number of results to display per page. |
| sort | array | no | An array of fields to sort the results by. |

### Create
`POST https://apizie.tech/v1/business:hubspot-conversations-custom-channels/post-conversations-custom-channels-2026-09-conversations-cus` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get a custom channel
`GET https://apizie.tech/v1/business:hubspot-conversations-custom-channels/get-conversations-custom-channels-2026-09-channel-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelId | integer | yes | The unique identifier of the custom channel to retrieve. It is an integer value. |

### Update a custom channel
`POST https://apizie.tech/v1/business:hubspot-conversations-custom-channels/patch-conversations-custom-channels-2026-09-channel-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelId | integer | yes | The unique identifier of the custom channel to update. |
| body | object | yes | JSON request body |

### Archive a custom channel
`POST https://apizie.tech/v1/business:hubspot-conversations-custom-channels/delete-conversations-custom-channels-2026-09-channel-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelId | integer | yes | The unique identifier of the custom channel to delete. |

### Update a channel account staging token
`POST https://apizie.tech/v1/business:hubspot-conversations-custom-channels/patch-conversations-custom-channels-2026-09-channel-id-chann` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| accountToken | string | yes | The unique token of the channel account staging to be updated. |
| channelId | integer | yes | The unique identifier of the custom conversation channel. |
| body | object | yes | JSON request body |

### Get accounts for a channel
`GET https://apizie.tech/v1/business:hubspot-conversations-custom-channels/get-conversations-custom-channels-2026-09-channel-id-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelId | integer | yes | The unique identifier of the channel for which to list the accounts. |
| after | string | no | The paging cursor token of the last successfully read resource will be returned as the `paging.next.after` JSON property of a paged… |
| archived | boolean | no | Whether to return only results that have been archived. |
| defaultPageLength | integer | no | The default number of results to display per page. |
| deliveryIdentifierType | array | no | An array of delivery identifier types to filter the results. Valid values include HS_EMAIL_ADDRESS, HS_PHONE_NUMBER, HS_SHORT_CODE, and… |
| deliveryIdentifierValue | array | no | An array of delivery identifier values to filter the results. |
| limit | integer | no | The maximum number of results to display per page. |
| sort | array | no | An array specifying the sort order of the results. |

### Create a channel account
`POST https://apizie.tech/v1/business:hubspot-conversations-custom-channels/post-conversations-custom-channels-2026-09-channel-id-channe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelId | integer | yes | The unique identifier of the custom channel for which the channel account is being created. |
| body | object | yes | JSON request body |

### Get a channel account by id
`GET https://apizie.tech/v1/business:hubspot-conversations-custom-channels/get-conversations-custom-channels-2026-09-channel-id-channel-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelAccountId | integer | yes | The unique identifier of the channel account to retrieve. |
| channelId | integer | yes | The unique identifier of the custom channel. |
| archived | boolean | no | Whether to return only results that have been archived. |

### Update a channel account
`POST https://apizie.tech/v1/business:hubspot-conversations-custom-channels/patch-conversations-custom-channels-2026-09-channel-id-chann-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelAccountId | integer | yes | The unique identifier of the channel account to update. |
| channelId | integer | yes | The unique identifier of the custom channel to which the account belongs. |
| body | object | yes | JSON request body |

### Publish a message
`POST https://apizie.tech/v1/business:hubspot-conversations-custom-channels/post-conversations-custom-channels-2026-09-channel-id-messag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelId | integer | yes | The unique identifier of the custom channel where the message will be created. |
| body | object | yes | JSON request body |

### Get a message
`GET https://apizie.tech/v1/business:hubspot-conversations-custom-channels/get-conversations-custom-channels-2026-09-channel-id-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelId | integer | yes | The unique identifier of the custom channel from which the message is to be retrieved. |
| messageId | string | yes | The unique identifier of the message to retrieve. |

### Update a message
`POST https://apizie.tech/v1/business:hubspot-conversations-custom-channels/patch-conversations-custom-channels-2026-09-channel-id-messa` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelId | integer | yes | The unique identifier of the custom channel that contains the message. |
| messageId | string | yes | The unique identifier of the message to update. |
| body | object | yes | JSON request body |

## Example
```
curl "https://apizie.tech/v1/business:hubspot-conversations-custom-channels/get-conversations-custom-channels-2026-09-conversations-cust" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the HubSpot Conversations Custom Channels API?
Create a free Apizie key, then send GET https://apizie.tech/v1/business:hubspot-conversations-custom-channels/get-conversations-custom-channels-2026-09-conversations-cust with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the HubSpot Conversations Custom Channels API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. HubSpot Conversations Custom Channels itself also needs your own key from hubapi.com.

### Can AI agents use the HubSpot Conversations Custom Channels API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key business:hubspot-conversations-custom-channels.

### What is the status of the HubSpot Conversations Custom Channels API?
Needs your own provider key (bring your own key)