Skip to content
MCP tools
View as Markdown
Updates dataLeadsMCP tool

leads_update

Update an existing lead's information or status.

Update an existing lead's information or status. Only provided fields are updated — omitted fields remain unchanged. Common uses: advance status as the lead warms up, correct contact details, or record the source. Returns the updated lead record.

Parameters#

ParameterTypeRequiredDescription
lead_idstringYesUUID of the lead to update · Format: UUID
first_namestringNoUpdated first name
last_namestringNoUpdated last name
emailstringNoUpdated email
phonestringNoUpdated phone
statusenumNoUpdated status · One of: new, contacted, qualified, unqualified, converted, lost
notesstringNoNotes to add

Example prompts#

  • "Mark Maria Garcia's lead as contacted and note that she wants a callback Friday."
  • "Update Tom Nguyen's phone to 661-555-0198 and set his status to qualified."

Safety#

Updates data. Changes an existing record. The change is visible immediately in the app and can be edited back.

Previous name#

This tool was previously published as update_lead. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.