ChatofyDevelopers
REST APIMCP Server (AI)New
API KeysWebhooks
Chatofy API
/
Getting Started
API Resources
API v1.0 Live
Developer APICRM Pipelines & DealsMove Deal Stage

Move Deal Stage

Moves a deal to a new stage in its pipeline. Status is derived from stage kind (open, won, lost). Emits timeline activity, audit log, and signed CRM webhooks.

POST/api/v1/deals/{id}/move

Body Parameters

1 parameter
{id}uuidrequired

Deal UUID to move

Request Body Schema

application/json
stage_iduuidrequired

Target pipeline stage UUID

lost_reasonstringoptional

Mandatory reason when moving to a lost stage

Example:Price / Too expensive

Response Payload

200 OKapplication/json
statusstring

"1" = Success, "0" = Failure.

messageobject

The response data payload.

Code Snippets & Examples

1curl -X POST "https://app.chatofy.in/api/v1/deals/d2222222-3333-4444-5555-666666666666/move" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"stage_id":"s3333333-3333-4444-5555-666666666666"}'

Was this endpoint guide helpful?

Previous Endpoint
Bulk Create Deals
Next Endpoint
Update Deal Attributes
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X POST "https://app.chatofy.in/api/v1/deals/d2222222-3333-4444-5555-666666666666/move" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"stage_id":"s3333333-3333-4444-5555-666666666666"}'
200 OKapplication/json
1{
2 "success": true,
3 "data": {
4 "deal": {
5 "id": "d2222222-3333-4444-5555-666666666666",
6 "title": "Annual Support SLA",
7 "value": 50000,
8 "value_weighted": 50000,
9 "currency": "INR",
10 "status": "won",
11 "stage_id": "s3333333-3333-4444-5555-666666666666",
12 "lost_reason": null,
13 "lost_at": null,
14 "stage_entered_at": "2026-10-27T01:10:00+05:30",
15 "updated_at": "2026-10-27T01:10:00+05:30"
16 }
17 },
18 "message": "Deal moved successfully"
19}