Conversations

List conversations

System threads (bounce notices and similar bookkeeping) are excluded unless you pass include_system=true.

For "who replied?", filter on has_inbound_message=true — it is an indexed boolean and far cheaper than scanning messages.

get/v1/conversations

Request

  • Base URL: https://api.automatedclientacquisition.com
  • URL: https://api.automatedclientacquisition.com/v1/conversations
  • Auth: HTTP bearer

Query parameters

limitinteger

Rows per page. Values above 100 are clamped to 100.

cursorstring

Opaque pagination cursor from the previous response's next_cursor. Treat it as a token — its encoding is not part of the contract.

channel'linkedin' | 'email' | 'whatsapp' | 'instagram' | 'telegram' | 'sms'
statusstring
contact_idstring uuid
has_inbound_messageboolean

Conversations where the contact has replied.

include_systemboolean

Include bookkeeping threads. Defaults to false.

Response

A page of conversations. messages is absent here.

successboolean
has_moreboolean
next_cursorstring nullable

Changes

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