conecto. Get started
CRM

List segments

crm_list_segments · Reads only · Markdown

The saved segments, each with its filters and how many records match right now.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Which saved lists do we have, and how many people are in each right now?

Your agent callscrm_list_segmentsFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "object": "contact"
}
What comes back
{
  "segments": [
    {
      "id": 4102,
      "object": "contact",
      "name": "Summer sale 2025 buyers",
      "filters": [
        {
          "field": "tag",
          "op": "eq",
          "value": "summer-sale-2025"
        }
      ],
      "sort": null,
      "updated_at": "2026-10-14T08:00:00+00:00",
      "count": 1
    },
    {
      "id": 4101,
      "object": "contact",
      "name": "Trade customers",
      "filters": [
        {
          "field": "tag",
          "op": "eq",
          "value": "trade"
        },
        {
          "field": "lifecycle_stage",
          "op": "eq",
          "value": "customer"
        }
      ],
      "sort": "name",
      "updated_at": "2026-10-14T08:00:00+00:00",
      "count": 1
    }
  ]
}

Use it when

To find a saved list by name before using it.

What comes back

Every saved segment with its object, name, filters, sort and how many records match now. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
objectstringOne of: contact,company,deal.

The call

Over MCP, call crm_list_segments on https://api.conecto.chat/mcp/crm. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/crm_list_segments \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"object":"contact"}'

More CRM tools

All 41 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md