---
title: "Create a new deal"
method: POST
path: "/deals"
tags: ["Deals"]
---

# Create a new deal

`POST /deals`

Creates a new deal in your CRM pipeline.

## Request body

- object
  - `title` string, required — Deal title
  - `pipelineId` string, required — Pipeline public ID
  - `stageId` string, required — Pipeline stage public ID
  - `clientId` string, required — Client public ID (required)
  - `leadId` string — Lead public ID
  - `sourceId` string — Deal source public ID
  - `price` number — Deal value/price
  - `expectedCloseDate` string, date-time — Expected close date
  - `priority` 'LOW' | 'MEDIUM' | 'HIGH' — Deal priority

## Response `200`

OK

- object
  - `id` string, required — Deal public ID
  - `number` string, nullable — Auto-generated deal number
  - `title` string, required — Deal title
  - `price` number, nullable — Deal price/value
  - `status` string, nullable — Deal status
  - `priority` string, nullable — Deal priority
  - `expectedCloseDate` string, date-time, nullable — Expected close date
  - `clientId` string, nullable — Client public ID
  - `pipelineId` string, nullable — Pipeline public ID
  - `stageId` string, nullable — Pipeline stage public ID
  - `sourceId` string, nullable — Deal source public ID
  - `leadId` string, nullable — Lead public ID
  - `createdAt` string, date-time, required — When the deal was created
  - `customFields` object, nullable — Custom field values

---

[API](https://skmtc.net/heffl/apis/heffl-api-v2-beta.md) · [All operations](https://skmtc.net/heffl/apis/heffl-api-v2-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heffl/heffl-api-v2-beta/revisions/27006cfef4d8/schema)