List incoming leads

Chats waiting in the Incoming leads stage to be accepted, declined or linked.

GET https://cotlet.dev/api/v1/kommo/incoming-leads

read

Returns chats that have not become leads yet, newest first, with the channel, the contact name, the first message and when it arrived. It works only when the Incoming leads stage is enabled for the pipeline; otherwise it returns an empty list. Follow next_cursor until it is null.

Parameters

Parameters: list_incoming_leads
NameTypeDescription
pipeline_id integer integer Only chats for this pipeline.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/kommo/incoming-leads \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("kommo", "list_incoming_leads")
Node.js
const result = await cotlet.call('kommo', 'list_incoming_leads');
CLI
cotlet call kommo list_incoming_leads

Example response

JSON

{
  "incoming": [
    {
      "chat_id": "c8f2a6d1",
      "channel": "WhatsApp",
      "contact_name": "Tom Becker",
      "first_message": "How much is a landing page for a dental clinic?",
      "received_at": "2026-10-20T07:41:00+02:00"
    },
    {
      "chat_id": "c1d7e9a3",
      "channel": "Instagram",
      "contact_name": "promo_deals_99",
      "first_message": "Earn 500 a day from home https://example.com/x",
      "received_at": "2026-10-20T06:12:00+02:00"
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.