# HubSpot Conversations API

**Canonical:** https://apis.io/apis/hubspot/hubspot-conversations-conversations-api/  
**Provider:** HubSpot — https://apis.io/providers/hubspot/  
**Base URL:** https://api.hubapi.com  
**Documentation:** https://developers.hubspot.com/docs/api-reference/latest/conversations/guide

HubSpot Conversations API is one of 144 APIs that [HubSpot](https://apis.io/providers/hubspot/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 692 JSON Schema definitions. Tagged areas include Conversations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, code examples, and 692 JSON Schemas.

HubSpot Conversations — 18 operation(s) from HubSpot's published OpenAPI.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| PUT | `/conversations/conversations/v3/threads/{threadId}/assignee` | — |
| DELETE | `/conversations/conversations/v3/threads/{threadId}/assignee` | — |
| POST | `/conversations/v3/conversations/actors/batch/read` | Get a group of actors |
| GET | `/conversations/v3/conversations/actors/{actorId}` | Get a single actor |
| GET | `/conversations/v3/conversations/channel-accounts` | Get channel accounts |
| GET | `/conversations/v3/conversations/channel-accounts/{channelAccountId}` | Get a single channel account |
| GET | `/conversations/v3/conversations/channels` | Get channels |
| GET | `/conversations/v3/conversations/channels/{channelId}` | Get a single channel |
| GET | `/conversations/v3/conversations/inboxes` | Get conversations inboxes |
| GET | `/conversations/v3/conversations/inboxes/{inboxId}` | Get a single conversations inbox |
| GET | `/conversations/v3/conversations/threads` | Get threads |
| GET | `/conversations/v3/conversations/threads/{threadId}` | Get a single thread |
| DELETE | `/conversations/v3/conversations/threads/{threadId}` | Archives a thread |
| PATCH | `/conversations/v3/conversations/threads/{threadId}` | Update a thread |
| GET | `/conversations/v3/conversations/threads/{threadId}/messages` | Get message history for a thread |
| POST | `/conversations/v3/conversations/threads/{threadId}/messages` | Send a message to a thread |
| GET | `/conversations/v3/conversations/threads/{threadId}/messages/{messageId}` | Get a single message |
| GET | `/conversations/v3/conversations/threads/{threadId}/messages/{messageId}/original-content` | Get the original content of a single message |

## Machine-readable artifacts (1066)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/openapi/hubspot-conversations-conversations-api-openapi.yml
- **Documentation** — https://developers.hubspot.com/docs/api/cms/domains
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-domain-collection-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-domain-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-forward-paging-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-next-page-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-domain-collection-response-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-domain-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-forward-paging-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-next-page-structure.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-domain-collection-response-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-domain-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-forward-paging-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-next-page-example.json
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/graphql/hubspot-graphql.md
- **Documentation** — https://developers.hubspot.com/docs/api/cms/source-code
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-action-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-asset-file-metadata-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-file-extract-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-file-upload-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-task-locator-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-error-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-result-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-warning-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-action-response-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-asset-file-metadata-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-file-extract-request-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-file-upload-request-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-task-locator-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-error-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-result-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-warning-structure.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-action-response-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-asset-file-metadata-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-file-extract-request-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-file-upload-request-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-task-locator-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-error-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-result-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-warning-example.json
- …and 1026 more, listed in full on the page.

## Other HubSpot APIs (12)

- [HubSpot URL Redirects API](https://apis.io/apis/hubspot/hubspot-url-redirects-api/)
- [HubSpot Pipelines API](https://apis.io/apis/hubspot/hubspot-pipelines-api/)
- [HubSpot Products API](https://apis.io/apis/hubspot/hubspot-products-api/)
- [HubSpot Line Items API](https://apis.io/apis/hubspot/hubspot-line-items-api/)
- [HubSpot Quotes API](https://apis.io/apis/hubspot/hubspot-quotes-api/)
- [HubSpot CRM Properties API](https://apis.io/apis/hubspot/hubspot-crm-properties-api/)
- [HubSpot Owners API](https://apis.io/apis/hubspot/hubspot-owners-api/)
- [HubSpot CRM Imports API](https://apis.io/apis/hubspot/hubspot-crm-imports-api/)
- [HubSpot Custom Objects API](https://apis.io/apis/hubspot/hubspot-custom-objects-api/)
- [HubSpot Marketing Events API](https://apis.io/apis/hubspot/hubspot-marketing-events-api/)
- [HubSpot Forms API](https://apis.io/apis/hubspot/hubspot-forms-api/)
- [HubSpot Workflows API](https://apis.io/apis/hubspot/hubspot-workflows-api/)

## Tags

Conversations

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hubspot/hubspot-conversations-conversations-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hubspot/.