# HubSpot Conversations Inbox & Messages API

> HubSpot Conversations Inbox & Messages API on Apizie: 18 endpoints (POST /conversations/conversations/2026-09/actors/batch/read, GET /conversations/conversations/2026-09/actors/{actorId}, GET /conversations/conversations/2026-09/channel-accounts, GET /conversations/conversations/2026-09/channel-accounts/{channelAccountId}, …) 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-conversations/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Basepom for all HubSpot Projects

## Endpoints

### POST /conversations/conversations/2026-09/actors/batch/read
`POST https://apizie.tech/v1/business:hubspot-conversations-conversations/post-conversations-conversations-2026-09-actors-batch-read` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| property | string | no |  |
| body | object | yes | JSON request body |

### GET /conversations/conversations/2026-09/actors/{actorId}
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-actors-actor-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| actorId | string | yes |  |
| property | string | no |  |

### GET /conversations/conversations/2026-09/channel-accounts
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-channel-accounts` (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… |
| archived | boolean | no | Whether to return only results that have been archived. |
| channelId | array | no |  |
| defaultPageLength | integer | no |  |
| inboxId | array | no |  |
| limit | integer | no | The maximum number of results to display per page. |
| sort | array | no |  |

### GET /conversations/conversations/2026-09/channel-accounts/{channelAccountId}
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-channel-accounts-cha` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelAccountId | integer | yes |  |
| archived | boolean | no | Whether to return only results that have been archived. |

### GET /conversations/conversations/2026-09/channels
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-channels` (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 |  |
| limit | integer | no | The maximum number of results to display per page. |
| sort | array | no |  |

### GET /conversations/conversations/2026-09/channels/{channelId}
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-channels-channel-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| channelId | integer | yes |  |

### GET /conversations/conversations/2026-09/inboxes
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-inboxes` (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… |
| archived | boolean | no | Whether to return only results that have been archived. |
| defaultPageLength | integer | no |  |
| limit | integer | no | The maximum number of results to display per page. |
| sort | array | no |  |

### GET /conversations/conversations/2026-09/inboxes/{inboxId}
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-inboxes-inbox-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| inboxId | integer | yes |  |
| archived | boolean | no | Whether to return only results that have been archived. |

### GET /conversations/conversations/2026-09/threads
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-threads` (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… |
| archived | boolean | no | Whether to return only results that have been archived. |
| associatedContactId | integer | no |  |
| associatedTicketId | integer | no |  |
| association | array | no |  |
| inboxId | array | no |  |
| latestMessageTimestampAfter | string | no |  |
| limit | integer | no | The maximum number of results to display per page. |
| property | string | no |  |
| sort | array | no |  |
| threadStatus | string | no |  |

### GET /conversations/conversations/2026-09/threads/{threadId}
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-threads-thread-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| threadId | integer | yes |  |
| archived | boolean | no | Whether to return only results that have been archived. |
| association | array | no |  |
| property | string | no |  |

### PATCH /conversations/conversations/2026-09/threads/{threadId}
`POST https://apizie.tech/v1/business:hubspot-conversations-conversations/patch-conversations-conversations-2026-09-threads-thread-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| threadId | integer | yes |  |
| archived | boolean | no | Whether to return only results that have been archived. |
| body | object | yes | JSON request body |

### DELETE /conversations/conversations/2026-09/threads/{threadId}
`POST https://apizie.tech/v1/business:hubspot-conversations-conversations/delete-conversations-conversations-2026-09-threads-thread-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| threadId | integer | yes |  |

### PUT /conversations/conversations/2026-09/threads/{threadId}/assignee
`POST https://apizie.tech/v1/business:hubspot-conversations-conversations/put-conversations-conversations-2026-09-threads-thread-id-as` (byok)

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

### DELETE /conversations/conversations/2026-09/threads/{threadId}/assignee
`POST https://apizie.tech/v1/business:hubspot-conversations-conversations/delete-conversations-conversations-2026-09-threads-thread-id-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| threadId | integer | yes |  |

### GET /conversations/conversations/2026-09/threads/{threadId}/messages
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-threads-thread-id-me` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| threadId | integer | yes |  |
| 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. |
| limit | integer | no | The maximum number of results to display per page. |
| property | string | no |  |
| sort | array | no |  |

### POST /conversations/conversations/2026-09/threads/{threadId}/messages
`POST https://apizie.tech/v1/business:hubspot-conversations-conversations/post-conversations-conversations-2026-09-threads-thread-id-m` (byok)

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

### GET /conversations/conversations/2026-09/threads/{threadId}/messages/{messageId}
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-threads-thread-id-me-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| messageId | string | yes |  |
| threadId | integer | yes |  |
| property | string | no |  |

### GET /conversations/conversations/2026-09/threads/{threadId}/messages/{messageId}/original-content
`GET https://apizie.tech/v1/business:hubspot-conversations-conversations/get-conversations-conversations-2026-09-threads-thread-id-me-3` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| messageId | string | yes |  |
| threadId | integer | yes |  |
| property | string | no |  |

## Example
```
curl "https://apizie.tech/v1/business:hubspot-conversations-conversations/post-conversations-conversations-2026-09-actors-batch-read" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the HubSpot Conversations Inbox & Messages API?
Create a free Apizie key, then send POST https://apizie.tech/v1/business:hubspot-conversations-conversations/post-conversations-conversations-2026-09-actors-batch-read with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the HubSpot Conversations Inbox & Messages 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-conversations.

### What is the status of the HubSpot Conversations Inbox & Messages API?
Needs your own provider key (bring your own key)