Save a pipeline
Creates a deal pipeline or changes one: its name, position and stages in order.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
Set up a separate pipeline for kitchen planners who apply for a trade account: application in, a demo in the test kitchen, first order, or not a fit.
Your agent callscrm_save_pipeline$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.
{
"name": "Trade accounts",
"stages": [
{
"name": "Application in",
"probability": 30
},
{
"name": "Test kitchen demo",
"probability": 60
},
{
"name": "First order",
"outcome": "won"
},
{
"name": "Not a fit",
"outcome": "lost"
}
]
}Use it when
The business sells in a way the default Sales pipeline does not fit, or its stages change.
What it does
Create a deal pipeline, or change one (by pipeline_id, or the pipeline with this name): its name, its position among the pipelines, and its stages in order. A stage that still holds deals cannot be dropped; move them first with crm_move_deal.
What comes back
The pipeline with its stages as saved, and created: true when it is new. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
pipeline_id | integer | At least 1. |
nameRequired | string | 1 to 80 characters. |
position | integer | 0 to 100. |
stages | array of objects | All the stages, in order. Keep a stage (and its deals) by giving its id or its current name. Won and Lost are added when no stage has those outcomes; open stages without a probability get one spread evenly. 1 to 30 items. |
stages[].id | integer | At least 1. |
stages[].nameRequired | string | 1 to 60 characters. |
stages[].probability | integer | 0 to 100. |
stages[].outcome | string | One of: open,won,lost. Default: open. |
The call
Over MCP, call crm_save_pipeline on https://api.conecto.chat/mcp/crm. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/crm_save_pipeline \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Trade accounts","stages":[{"name":"Application in","probability":30},{"name":"Test kitchen demo","probability":60},{"name":"First order","outcome":"won"},{"name":"Not a fit","outcome":"lost"}]}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No pipeline has that pipeline_id. | Call crm_list_pipelines and use one of its ids. |
invalid_input400 | A new pipeline has no stages, no stage is open, two stages share a name, or a stage id belongs to another pipeline. | Send every stage in order with its own name and at least one open stage. |
conflict409 | Another pipeline already has that name, or a stage left out still holds deals. | Pick another name, or move the deals with crm_move_deal first. |
limit_reached409 | The business has as many pipelines as it may. | Delete a pipeline it no longer uses with crm_delete_pipeline. |
More CRM tools
All 41 tools- 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* - Save a contact
crm_save_contactCreates a contact, or updates the one with the same email; only the fields you send change.$0.01 a call - Save many contacts
crm_save_contactsCreates or updates up to 100 contacts in one call, each like crm_save_contact; you pay only for the ones saved.$0.01 per record saved - Update a contact
crm_update_contactChanges fields on a contact by its id, its email included; only the fields you send change.$0.01 a call - Archive a contact
crm_archive_contactHides a contact from searches and lists; its history is kept.$0.001 a call
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