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

Create Deal

Creates a sales deal. Status is automatically derived from the stage kind.

POST/api/v1/deals

Request Body Schema

application/json
titlestringrequired

Deal name or title

Example:Annual Support SLA
valuenumberoptional

Monetary value with 2 decimal places

Example:50000
currencystringoptional

Currency code (default INR)

Example:INR
expected_close_datestringoptional

Expected close date (YYYY-MM-DD)

Example:2026-11-30
owner_iduuidoptional

Assigned user UUID

product_iduuidoptional

Product UUID to link this deal to

Example:prod-1111111-2222-3333-4444-555555555555
contact_iduuidoptional

Contact UUID to link this deal to

Example:c1111111-2222-3333-4444-555555555555
phonestringoptional

Contact phone number (E.164)

Example:+919876543210
pipeline_iduuidoptional

Target pipeline UUID (defaults to first org pipeline)

stage_iduuidoptional

Target stage UUID (defaults to initial stage)

statusstringoptional

Deal status (must match stage kind if provided)

lost_reasonstringoptional

Reason for loss (required if stage is lost)

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" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"title":"Annual Support SLA","value":50000,"phone":"+919876543210"}'

Was this endpoint guide helpful?

Previous Endpoint
List Deals
Next Endpoint
Bulk Create Deals
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X POST "https://app.chatofy.in/api/v1/deals" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"title":"Annual Support SLA","value":50000,"phone":"+919876543210"}'
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": 5000,
9 "currency": "INR",
10 "status": "open",
11 "owner_id": null,
12 "expected_close_date": null,
13 "lost_reason": null,
14 "lost_at": null,
15 "pipeline_id": "p1111111-2222-3333-4444-555555555555",
16 "stage_id": "s1111111-2222-3333-4444-555555555555",
17 "contact_id": "c1111111-2222-3333-4444-555555555555",
18 "created_at": "2026-10-26T10:15:00+05:30",
19 "updated_at": "2026-10-26T10:15:00+05:30"
20 }
21 },
22 "message": "Deal created successfully"
23}