Skip to content
MCP tools
Bulk changesBulk operationsMCP tool

bulk_update_lead_status

Update multiple leads' status at once for bulk lead management.

Last updated

Update multiple leads' status at once for bulk lead management.

Warning

This affects multiple records permanently. Common use cases: marking old leads as "lost" after cleanup review, updating all contacted leads to "qualified" after qualification calls, batch setting leads to "unqualified" after failed contact attempts. Returns: count of successfully updated leads, any failures with reasons. Always verify the lead_ids list before calling — consider using leads_list first to confirm you have the right records. Status transitions: new→contacted→qualified→converted (success path) or →unqualified/lost (failure path).

Parameters#

ParameterTypeRequiredDescription
lead_idsarray of stringsYesArray of lead UUIDs to update. Max 500 per call. Use leads_list to get IDs. · Max items: 500 · Min items: 1
new_statusenumYesNew status to set for ALL specified leads. converted should only be used via leads_convert for proper client creation. · One of: new, contacted, qualified, unqualified, converted, lost
notesstringNoNotes to append to all updated leads. Example: "Bulk marked lost - no response after 6 months". · Max length: 1000

Example prompts#

  • "Mark all the leads I called yesterday as contacted in one go."
  • "Set those 30 stale Zillow leads to lost, but show me the list before updating."

Safety#

Bulk changes. Changes many records in one call. Review the scope carefully before confirming — bulk changes are treated as destructive because of their blast radius.