Retrieve conversation threads from HubSpot Conversations. You can apply optional filters (inbox, OPEN/CLOSED status, associated contact or ticket, time window) and sorting to tailor the results. Paginated: pass after from the previous response's paging.next.after.

Retrieve detailed information about a conversation thread by ID: status, inbox, original channel, assignee and associated contact.

Update a single thread's status (OPEN/CLOSED) or archive/restore it. Set is_thread_archived=true to archive, false to restore an archived thread.

Archives a conversation thread, marking it for deletion. The thread is permanently deleted after 30 days.

Retrieve the message history for a given conversation thread by its ID (messages, comments and system events like assignments and status changes). Paginated: pass after from paging.next.after to fetch the next page.

Retrieve the details of a specific message within a conversation thread using the message ID.

Retrieve the original text and rich text of a message — useful for untruncated content when the message's truncationStatus indicates it might be truncated.

Send a new message on an existing conversation thread — delivered to the customer on the thread's channel (set message_type=COMMENT for an internal note instead). Provide the content either as typed fields (text, recipients, …) or as a stringified JSON request_body; typed fields win on conflict. Missing channel_id/channel_account_id are taken from the thread, missing recipients are derived from the latest incoming message, and sender_actor_id falls back to HUBSPOT_DEFAULT_SENDER_ACTOR_ID. Call with mode='get_request_schema' to inspect the raw request body schema.

Fetch a list of conversation inboxes (shared inboxes and help desks), with optional filters and sorting to customize the results.

Retrieve detailed information about a specific conversation inbox by its ID.

Retrieve a list of conversation channels (e.g. email, live chat, forms, WhatsApp), with optional filters and sorting if needed.

Retrieve comprehensive details about a specific channel in HubSpot Conversations by providing the channel ID.

Retrieve a list of channel accounts — concrete instances of a channel connected to an inbox (e.g. a specific email address or phone number). Supports optional filters and sorting to refine the results.

Fetch detailed information about a specific HubSpot channel account using the channel account ID, such as its status and configuration.

Retrieve details of a specific actor (conversation participant) by actor ID. Actor IDs are prefixed by type: 'A-' agent/user, 'V-' visitor/contact, 'B-' bot, 'E-' email, 'S-' system, 'I-' integrator.

Resolve a list of ActorIds to detailed participant information in one batch call — use this to understand who the participants in a conversation are.

Create a new account within a specific custom communication channel. Enables multiple accounts to communicate over a single channel with different delivery identifiers. Requires the conversations.custom_channels.write scope.

Fetch the list of accounts associated with a specific custom channel, identified by the channel ID.

Retrieve detailed metadata about a channel account on a custom channel, including its channel, inbox ID, and delivery identifiers.

Update the name and/or authorization status of a channel account on a custom channel — including disabling the account by setting set_authorization_status to false.

Update the account name and delivery identifier of a channel account staging token (public app connection flow) in HubSpot Conversations.

Publish a message over a specified custom channel into HubSpot Conversations — used by custom-integrated messaging channels to sync external messages into HubSpot. Provide the message either as typed fields or as a stringified JSON request_body (typed fields win on conflict). Requires channelAccountId, senders and recipients. Call with mode='get_request_schema' to inspect the raw request body schema.

Get the details of a specific message sent through a custom channel — message content, sender information, and timestamps.

Update the delivery status of a message within a custom channel: SENT, FAILED, or READ. For FAILED messages, include an error message for clarification.