Move a lead to a pipeline stage
Moves a lead to a different stage. Resolve the stage ID from the pipeline stages endpoint first; stage names are workspace configuration and differ between workspaces. Moving a lead into a lost stage requires a close reason and stops any sequence still running for them. Moving one on hold requires a wake date.
/campaigns.leads.updateLeadStageAuthorization
bearerAuth Enter your MailMoo API key (format: sk_live_...)
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/campaigns.leads.updateLeadStage" \ -H "Content-Type: application/json" \ -d '{ "leadId": "3c6e2b8e-0e8f-48db-8791-27271df10113", "pipelineStageId": "07dd84d5-9ace-4c3a-bee6-6bd4c6704f7f" }'{ "id": "string", "workspaceId": "string", "leadGroupId": "string", "tagId": "string", "pipelineStageId": "string", "closeReason": "NOT_ICP", "closedFromCategory": "NEW", "stageSetManuallyAt": "string", "followUpAt": "string", "lastActivityAt": "string", "cycle": 0, "profilePictureUrl": "string", "meetingBookedAt": "string", "meetingBookedSource": "VIDEO_LANDING_PAGE", "createdAt": "string", "updatedAt": "string", "property1": null, "property2": null}Tool reference
Every tool the MCP server exposes, what it does, and the permissions a key needs to reach it.
Set when to pick a lead back up POST
Sets or clears a lead's catch-up date. A lead with a date in the past shows up in triage until someone messages them, which clears it. This is separate from a task: a catch-up date says when to return to the deal, a task is a to-do someone wrote.