HubSpot Conversations Custom Channels

Name: Conversations Custom Channels API
Brand: Conversations Custom Channels
Availability: InStock

✓ Official Vendor SpecCommunicationsChat Messagingoauth2, apiKey13 Endpoints

Install Jentic One Beta

Connect the Conversations Custom Channels to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Conversations Custom Channels, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Conversations Custom Channels API.

Create a custom channel that surfaces in HubSpot's shared inbox

Publish inbound messages from the external platform into HubSpot

GET STARTED

Start building with Conversations Custom Channels API

Explore with Jentic

View OpenAPI Document

For Agents

Register and operate custom messaging channels inside HubSpot conversations, including publishing messages and managing channel accounts. Useful for agents bridging an external chat platform into HubSpot.

Use for: Create a custom conversation channel for an external chat platform, Publish an inbound message from an external messenger into HubSpot, Register a channel account when a user installs the integration, Update the state of a previously published custom-channel message

Not supported: Does not read native HubSpot inbox threads, identify website visitors, or send transactional email - use for registering and operating custom messaging channels only.

Use Cases

Patterns agents use Conversations Custom Channels API for, with concrete tasks.

★ Bridging an External Chat into HubSpot

A SaaS vendor with its own chat product surfaces conversations inside HubSpot Service Hub by registering a custom channel and publishing each new external message into HubSpot. POST /conversations/v3/custom-channels/ creates the channel; POST /conversations/v3/custom-channels/{channelId}/messages publishes inbound messages so they appear in the shared inbox.

POST /conversations/v3/custom-channels/ once at install time to create the channel, then POST /conversations/v3/custom-channels/{channelId}/messages for each new inbound message.

Per-Account Channel Provisioning

Provision a separate channel account whenever a HubSpot customer connects their workspace in the external platform. The API supports creating, updating, and querying channel accounts, plus rotating staging tokens used during the OAuth-style install handshake.

On install completion, POST /conversations/v3/custom-channels/{channelId}/channel-accounts with the connected workspace identifiers.

Sync Read and Delivered State

Mirror external read or delivered receipts back into HubSpot so the inbox view stays in sync with the source platform. PATCH /conversations/v3/custom-channels/{channelId}/messages/{messageId} updates a published message's state without re-publishing the body.

On a read-receipt event, PATCH /conversations/v3/custom-channels/{channelId}/messages/{messageId} setting the new status.

Agent-Driven External Bridge

Use Jentic to let an integration agent register channels and publish messages on behalf of customers without bespoke HubSpot client code. The HubSpot OAuth token is held in your Jentic One instance, and the agent invokes channel operations by intent rather than constructing requests by hand.

Use Jentic search 'publish a message into a HubSpot custom channel', load the POST /conversations/v3/custom-channels/{channelId}/messages schema, and execute with the channelId and message payload.

Key Endpoints

13 endpoints — the hubspot conversations custom channels api lets developers register external messaging surfaces - such as a proprietary chat platform or third-party messenger - as channels inside hubspot's shared inbox.

METHOD

PATH

DESCRIPTION

GET

/conversations/v3/custom-channels/

List all custom channels for the app

POST

/conversations/v3/custom-channels/

Create a custom channel

PATCH

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

Update a custom channel

POST

/conversations/v3/custom-channels/{channelId}/messages

Publish a message

PATCH

/conversations/v3/custom-channels/{channelId}/messages/{messageId}

Update a published message

POST

/conversations/v3/custom-channels/{channelId}/channel-accounts

Create a channel account

DELETE

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

Archive a custom channel

GET

/conversations/v3/custom-channels/

List all custom channels for the app

POST

/conversations/v3/custom-channels/

Create a custom channel

PATCH

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

Update a custom channel

POST

/conversations/v3/custom-channels/{channelId}/messages

Publish a message

PATCH

/conversations/v3/custom-channels/{channelId}/messages/{messageId}

Update a published message

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your HubSpot access token or private app token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'create a HubSpot custom channel' or 'publish a message into HubSpot', and Jentic returns the matching Custom Channels operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using Conversations Custom Channels API through Jentic.

What authentication does the HubSpot Custom Channels API use?

OAuth 2.0 authorization code flow, a private app token in the `private-app` header, or developer hapikey as a query parameter. Through Jentic, credentials are stored encrypted in the vault and the agent only sees a scoped execution token.

Can I publish a message from an external platform into HubSpot's inbox?

Yes. POST /conversations/v3/custom-channels/{channelId}/messages publishes a message into the channel so it appears in the shared inbox alongside native conversation channels.

What are the rate limits for the Custom Channels API?

Standard HubSpot API limits apply - roughly 100 requests per 10 seconds per OAuth app and daily caps on paid tiers. Spread message publication evenly to stay below the per-second ceiling.

How do I register a custom channel through Jentic?

Search Jentic for `create a HubSpot custom channel`, load the POST /conversations/v3/custom-channels/ schema, and execute with the channel name and webhook configuration. Install with `pip install jentic` and authenticate using `JENTIC_AGENT_API_KEY`.

Can I update the state of a previously published message?

Yes. PATCH /conversations/v3/custom-channels/{channelId}/messages/{messageId} updates an already-published message - useful for syncing read receipts or delivery status from the source platform.

Can I limit what my agent is allowed to do with the HubSpot Custom Channels API?

Yes. Because you run Jentic One yourself, your own rules decide which Custom Channels operations and credentials the agent may use. Since the channel id lives in the URL path (/conversations/v3/custom-channels/{channelId}), you can pin the agent to a single channel and allow only the calls you choose, such as publishing messages or updating a message's state. Destructive operations like archiving a channel with DELETE /conversations/v3/custom-channels/{channelId} are excluded unless you explicitly add them.

HubSpot Conversations Custom Channels

Connect the Conversations Custom Channels to your agent

Capabilities

Start building with Conversations Custom Channels API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs