Delete a segment
Deletes a saved segment; the records in it stay as they are.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
We don't need the summer sale 2025 buyers list any more. Delete it, but keep the people.
Your agent callscrm_delete_segment$0.001 a call
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"object": "contact",
"segment": "Summer sale 2025 buyers"
}Use it when
A saved list is no longer needed.
What it does
Delete a saved segment; the records stay as they are.
What comes back
deleted: the segment's name. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
objectRequired | string | One of: contact,company,deal. |
segmentRequired | string | Name or id. 1 to 80 characters. |
The call
Over MCP, call crm_delete_segment on https://api.conecto.chat/mcp/crm. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/crm_delete_segment \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"object":"contact","segment":"Summer sale 2025 buyers"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No saved segment of that object has that name or id. | Call crm_list_segments; the message also names the saved segments. |
More CRM tools
All 41 tools- Export as CSV
crm_exportContacts, companies or deals as CSV text, with the same filters, tag and segment as the find tools.Free* - Find duplicates
crm_find_duplicatesContacts or companies that are probably the same record twice, grouped, with the reason.Free* - Merge contacts
crm_merge_contactsMerges duplicate contacts into the one you keep; their notes, emails, chats, calls and deals move with them.$0.01 a call - Merge companies
crm_merge_companiesMerges duplicate companies into the one you keep; their people, deals and notes move with them.$0.01 a call - Search the CRM
crm_searchFinds contacts, companies and deals from whatever you have: a name, an email, a phone number in any format, a domain or a deal title.Free* - Find contacts
crm_find_contactsFinds contacts by name, email, company or phone, by filters on any field or tag, or by a saved segment, one page at a time.Free* - Get a contact
crm_get_contactOne contact, by id or email, with its tags, custom fields, recent activity, open tasks and deals.Free* - Everything open with a customer
crm_get_customerEverything open with one customer in one read: deals, tickets, invoices, quotes, signatures, meetings and their last messages.Free*
Read next: The best AI agents for small business in 2026, The best MCP servers for small business in 2026, What is an MCP server?
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md