CRM

Update a contact

crm_update_contact · Changes data · Markdown

Changes fields on a contact by its id, its email included; only the fields you send change.

$0.01 a call

From your agent’s balance. A call that fails costs nothing.

Sophie Lange just paid for her espresso machine. Mark her as a customer and save her new number, 040 66969 214.

Your agent callscrm_update_contact$0.01 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.

With these arguments

{
  "contact_id": 4812,
  "phone": "+49 40 66969 214",
  "lifecycle_stage": "customer"
}

What comes back

{
  "contact": {
    "id": 4812,
    "email": "sophie.lange@example.com",
    "name": "Sophie Lange",
    "title": "",
    "company": "",
    "company_id": null,
    "phone": "+49 40 66969 214",
    "location": "Hamburg",
    "lifecycle_stage": "customer",
    "outreach_status": null,
    "notes": "",
    "tags": [
      "cold"
    ],
    "custom_fields": {},
    "archived": false,
    "updated_at": "2026-10-14T08:00:00+00:00"
  }
}

Use it when

A known contact's details or stage change, especially their email address.

For a person you know only by email, or who may be new, use crm_save_contact.

What it does

Change fields on an existing contact by id. Only the fields you send change; tags are added, custom fields merged.

What comes back

The contact as it now is. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`contact_id`Required	integer	At least 1.
`email`	string (email)	Up to 254 characters.
`name`	string	Up to 255 characters.
`title`	string	Up to 255 characters.
`company`	string	Company name; also links or creates the company record. Up to 255 characters.
`phone`	string	Up to 60 characters.
`location`	string	Up to 255 characters.
`timezone`	string	Up to 60 characters.
`language`	string	Up to 60 characters.
`lifecycle_stage`	string	One of: lead,trial,onboarding,customer,at_risk,churned,advocate.
`notes`	string	Up to 20,000 characters.
`custom_fields`	object	Custom fields as {"key": value}, merged into the existing ones; null clears one. Keys defined with crm_define_field are checked against their type.
`tags`	array of strings	Tags to add, e.g. ["vip"]; a new tag is made on first use. crm_tag_records removes tags. Up to 20 items.

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/crm_update_contact \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_id":4812,"phone":"+49 40 66969 214","lifecycle_stage":"customer"}'

When it refuses

A refused call costs nothing and says what to do next.

Code	When	What to do
`not_found`404	No contact of the business matches that contact_id or email.	Find the person with crm_search and use the id it returns.
`invalid_input`400	A custom field value does not fit the field's type, or the record would hold too many custom fields.	Send a value of the type crm_list_fields shows for that key, or null to clear it.
`conflict`409	Another contact already has that email.	Merge the two with crm_merge_contacts, or keep the email as it is.

More CRM tools

All 41 tools

Give this to your agent.

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

Update a contact

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More CRM tools

Give this to your agent.