Contacts

Get contact conversations

Find real email, SMS, and call conversations by the contacts’ stored email addresses and phone numbers, without a helpdesk ticket requirement. Includes open and closed threads by default, with no recent-date cutoff. Excludes junk/deleted streams and synthetic bulk-campaign activity. Newest message first, across accessible inboxes. API keys have company scope; delegate tokens need contacts:* read scope and follow current membership, inbox/team/monitor and contact-type sharing permissions (respecting channel opt-outs). Every contact must be active and in the authenticated company. Empty addresses return an empty page.

get/api/contacts/{contactId}/conversations

Request

Path parameters

contactIdstring required

Query parameters

status'all' | 'open' | 'closed'
inboxIdstring

Channel meta.id; narrows authorized inboxes, never expands access.

searchstring

Subject contains text; comma-separated literal alternatives.

skipinteger
limitinteger

Response

A page of matching conversations.

personIdsstring[] required
hasMoreboolean required

When true, request the next page with skip + limit.

skipinteger required
limitinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.