Skip to main content
GET
/
conversations
/
v3
/
conversations
/
threads
/
{threadId}
/
messages
Get message history for a thread
curl --request GET \
  --url https://api.hubapi.com/conversations/v3/conversations/threads/{threadId}/messages \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "type": "MESSAGE",
      "id": "<string>",
      "conversationsThreadId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "createdBy": "<string>",
      "client": {
        "clientType": "HUBSPOT",
        "integrationAppId": 123
      },
      "senders": [
        {
          "actorId": "<string>",
          "deliveryIdentifier": {
            "type": "<string>",
            "value": "<string>"
          },
          "name": "<string>",
          "senderField": "<string>"
        }
      ],
      "recipients": [
        {
          "deliveryIdentifier": {
            "type": "<string>",
            "value": "<string>"
          },
          "actorId": "<string>",
          "name": "<string>",
          "recipientField": "<string>"
        }
      ],
      "archived": true,
      "text": "<string>",
      "attachments": [
        {
          "fileId": "<string>",
          "fileUsageType": "<string>",
          "type": "FILE",
          "name": "<string>",
          "url": "<string>"
        }
      ],
      "truncationStatus": "NOT_TRUNCATED",
      "direction": "INCOMING",
      "channelId": "<string>",
      "channelAccountId": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "richText": "<string>",
      "subject": "<string>",
      "inReplyToId": "<string>",
      "status": {
        "statusType": "FAILED",
        "failureDetails": {
          "errorMessageTokens": {},
          "errorMessage": "<string>"
        }
      }
    }
  ],
  "paging": {
    "next": {
      "after": "<string>",
      "link": "<string>"
    }
  }
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

threadId
integer<int64>
required

The unique ID of the thread.

Query Parameters

after
string

The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.

archived
boolean

Whether to return only results that have been archived.

limit
integer<int32>

The maximum number of results to display per page.

property
string

A specific property to include in the message response.

sort
string[]

Sort direction. Valid options are createdAt (ascending), and -createdAt (descending, default)

Response

successful operation

results
object[]
required
paging
object
Last modified on December 16, 2025