Update or move an opportunity
This is how you move a deal. stageId reaches any stage in the opportunity’s pipeline, including won and lost ones.
win and lose are shortcuts over this endpoint and pick the first stage of that type. If your pipeline has more than one — “Closed Won — Annual” and “Closed Won — Pilot” — name the stage here instead; the shortcuts cannot tell them apart.
closedAt follows the stage type in both directions, so moving back to an open stage reopens the deal. A stage belonging to a different pipeline is rejected: to move pipelines, send pipelineId and stageId together.
Only the fields you send are changed, and each one records its own entry in the opportunity’s history. Permissions match the app — without opportunities.editAll you can only change deals you own.
Authorizations
Your API key, created in the Leadey dashboard under Settings → API Keys. Send it as Authorization: Bearer leadey_sk_live_….
Path Parameters
Body
Response
Success