Conversations

List contact threads grouped by toNumber

Returns one entry per unique normalized phone number across all conversations in the org. Each entry is the representative (most-recent) conversation enriched with conversationIds and normalizedNumber.

get/api/v1/conversations/threads

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/api/v1/conversations/threads
  • Auth: bearerAuth (a scheme the document does not define)

Query parameters

pageinteger
limitinteger
campaignIdstring uuid

Filter by campaign

channel'whatsapp' | 'sms' | 'email' | 'instagram'

Filter by channel

searchstring

Search by phone number or message content

activityState'active' | 'closed'

Filter by activity state

handoffState'ai' | 'human'

Filter by handoff state

autoReplyActivestring

Filter by auto-reply

needsReplystring

Filter conversations awaiting reply

phoneNumberIdstring uuid

Filter by our phone number UUID

assignedUserIdstring uuid

Filter threads assigned to a specific user UUID

Response

Success

successtrue required
messagestring

Changes

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