OpenAPI 3.0.3raw.githubusercontent.com2026-08-17184193610.6 KB

eb3dc75cc05b

Conversations

List conversations

List inbox threads, most recently active first. A conversation groups every message with one contact across channels, which is what you need to build an inbox: GET /v1/messages returns a flat log with no thread to hang it on.

Use senderId to scope the list to a single number, and channel to keep only threads that have carried that channel.

get/v1/conversations

Query parameters

channel'sms' | 'sms_oneway' | 'whatsapp' | 'email' | 'telegram' | 'instagram' | 'messenger' | 'voice'

Keep only threads that have carried this channel.

senderIdstring

Keep only threads last handled by this sender.

limitinteger
cursorstring

Opaque cursor from a previous response's nextCursor. Do not construct it.

Response

List of conversations.

nextCursorstring nullable

Example response

{
  "items": [
    {
      "id": "js723987cyghwqxxaxcf590qd18axd95",
      "contactIdentifier": "+56912345678",
      "channels": [
        "whatsapp",
        "sms"
      ]
    }
  ]
}