メインコンテンツへスキップ
GET
/
conversations
/
conversations
/
2026-09-beta
/
threads
スレッドを取得
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

承認

Authorization
string
header
必須

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

クエリパラメータ

after
string

最後に正常に読み取られたリソースのページ操作カーソルトークンは、より多くの結果を含むページ付きレスポンスのpaging.next.after JSONプロパティーとして返されます。

archived
boolean

アーカイブ済みの結果のみを返すかどうか。

associatedContactId
integer<int64>

スレッドをフィルタリングするための、関連付けられたコンタクトの一意の識別子。

associatedTicketId
integer<int64>

スレッドをフィルタリングするための、関連付けられたチケットの一意の識別子。

association
enum<string>[]

レスポンスに含める関連付けのリスト。有効な値は「TICKET」です。

利用可能なオプション:
TICKET
inboxId
integer<int32>[]

スレッドをフィルターする受信トレイIDのリスト。

latestMessageTimestampAfter
string<date-time>

指定された日時以降の最新メッセージタイムスタンプを持つスレッドのみにフィルターします。

limit
integer<int32>

ページごとに表示する結果の最大数。

property
string

レスポンスに含める特定のプロパティー。

sort
string[]

結果を並べ替えるフィールドのリスト。

threadStatus
enum<string>

スレッドのステータスで絞り込みます。有効な値は「OPEN」または「CLOSED」です。

利用可能なオプション:
CLOSED,
OPEN

レスポンス

successful operation

results
object[]
必須
paging
object
Last modified on April 13, 2026