Contacts

Updated September 7, 2026

A contact is built from conversations: the name from a messenger or form, phone and email from widget contact collection. The list is easy to pull into a CRM, mailing tool or analytics.

GET /contacts

Parameter	Type	Description
channel	query	Filter by first-contact channel
tag	query	Filter by tag
updatedSince	query	ISO date: only records changed after it — for incremental sync
limit	query	1–100, default 50
cursor	query	next page cursor

Response 200

{
  "items": [
    {
      "id": "ct_7731",
      "name": "Kira Meshcheryakova",
      "phone": null,
      "email": null,
      "channel": "telegram",
      "tags": ["delivery"],
      "dialogsCount": 4,
      "ratingAvg": 4.7,
      "firstSeenAt": "2026-08-21T09:12:00Z",
      "updatedAt": "2026-09-07T12:01:00Z"
    }
  ],
  "nextCursor": null
}

For regular CRM sync, store the time of the last request and pass it as updatedSince — only changed contacts will be returned.

← Messages →Webhooks