Move a lead

Change a lead's stage and schedule its next follow-up in one request.

PATCH /v1/leads/{id} changes only the fields you send. To move a deal forward and book the next call:

curl -X PATCH "https://api.leadup.group/v1/leads/0192f0c1-7a3e-7c51-9d2e-4b7f0a1c2d3e" \
  -H "Authorization: Bearer $LEADUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "stage": "meeting", "nextFollowUpAt": "2026-10-20T14:00:00Z" }'

The response is the updated lead. The key needs leads:update.

The stages

A lead moves through six stages: prospect, contacted, meeting, proposal, then won or lost. Any stage may follow any other, so your integration can mirror how your team really works.

Was this page helpful?