curl --request GET \
--url https://api.hubapi.com/conversations/conversations/2026-09-beta/threads \
--header 'Authorization: Bearer <token>'{
"results": [
{
"archived": true,
"associatedContactId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"inboxId": "<string>",
"originalChannelAccountId": "<string>",
"originalChannelId": "<string>",
"spam": true,
"status": "CLOSED",
"assignedTo": "<string>",
"closedAt": "2023-11-07T05:31:56Z",
"latestMessageReceivedTimestamp": "2023-11-07T05:31:56Z",
"latestMessageSentTimestamp": "2023-11-07T05:31:56Z",
"latestMessageTimestamp": "2023-11-07T05:31:56Z",
"threadAssociations": {
"associatedTicketId": "<string>"
}
}
],
"paging": {
"next": {
"after": "<string>",
"link": "<string>"
}
}
}Retrieve a list of conversation threads from the specified inboxes in your HubSpot account. This endpoint allows you to filter threads by associated contacts, tickets, status, and more. Useful for managing and reviewing communication threads efficiently.
curl --request GET \
--url https://api.hubapi.com/conversations/conversations/2026-09-beta/threads \
--header 'Authorization: Bearer <token>'{
"results": [
{
"archived": true,
"associatedContactId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"inboxId": "<string>",
"originalChannelAccountId": "<string>",
"originalChannelId": "<string>",
"spam": true,
"status": "CLOSED",
"assignedTo": "<string>",
"closedAt": "2023-11-07T05:31:56Z",
"latestMessageReceivedTimestamp": "2023-11-07T05:31:56Z",
"latestMessageSentTimestamp": "2023-11-07T05:31:56Z",
"latestMessageTimestamp": "2023-11-07T05:31:56Z",
"threadAssociations": {
"associatedTicketId": "<string>"
}
}
],
"paging": {
"next": {
"after": "<string>",
"link": "<string>"
}
}
}Supported products
Required Scopes
The access token received from the authorization server in the OAuth 2.0 flow.
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.
Whether to return only results that have been archived.
The unique identifier of the associated contact to filter the threads.
The unique identifier of the associated ticket to filter the threads.
A list of associations to include in the response. Valid values include 'TICKET'.
TICKET A list of inbox IDs to filter the threads.
Filter threads to only include those with a latest message timestamp after the specified date-time.
The maximum number of results to display per page.
A specific property to include in the response.
A list of fields to sort the results by.
The status of the thread to filter by. Valid values are 'OPEN' or 'CLOSED'.
CLOSED, OPEN Was this page helpful?