v1

latestOpenAPI 3.1.02026-07-26359254.7 MB
Inbox

Filter inbox threads

<small>Requires the inbox:read scope (or a broader one that includes it).</small>

Returns a paginated page of inbox threads matching the supplied filter. All filter fields are optional — the empty body matches the same set as GET /v3/inbox/threads.

post/v3/inbox/threads/filter

Query parameters

topinteger
skipinteger

Request body

searchstring nullable

Free-text search across subject, body preview, and contact identifiers.

ownerUserIdinteger nullable

Restrict to threads owned by the given user. The target must be a member of the caller's team; otherwise the request fails with 400 inboxThread.invalidInput.

sequenceIdsinteger[] nullable
emailAccountIdsinteger[] nullable
linkedInAccountIdsinteger[] nullable
contactIdsinteger[] nullable
channelsstring[] nullable

Restrict to threads on the given channels. unknown is rejected by validation.

categoryIdsinteger[] nullable
onlyWithMeetingIntentboolean nullable
source'inbox' | 'sent' | 'unread' | 'aiDraft' nullable

Predefined source bucket:

  • inbox — all threads with at least one inbound message.
  • sent — threads where the latest activity is outbound.
  • unread — only unread threads.
  • aiDraft — threads with a pending AI-drafted reply.
fromstring date-time nullable
tostring date-time nullable

Upper bound on lastActivityDate. Must be strictly after from when both are supplied.

Response

Filtered threads page

hasMoreboolean required