---
title: "Create Deal"
method: POST
path: "/deals"
tags: ["Deals"]
---

# Create Deal

`POST /deals`

## Request

- Base URL: `https://api.feedback1.ai/api/v1`
- URL: `https://api.feedback1.ai/api/v1/deals`
- Auth: HTTP bearer

Create a new deal.

## Request body

- DealCreate: Create deal request
  - `name` string, required
  - `value` number, nullable
  - `currency` string, nullable: Currency code (e.g., USD)
  - `stage` string, nullable
  - `probability` integer, nullable: Win probability (0-100)
  - `expected_close_date` string, date-time, nullable
  - `account_id` string, nullable: Account ID
  - `contact_id` string, nullable: Primary contact ID

## Response `201`

Successful Response

- DealResponse: Deal response for Public API
  - `id` string, required
  - `name` string, required
  - `value` number, nullable
  - `currency` string, nullable
  - `stage` string, nullable
  - `probability` integer, nullable
  - `expected_close_date` string, date-time, nullable
  - `lost_reason` string, nullable
  - `account_id` string, nullable
  - `account` DealAccountInfo: Account info in deal response
    - `id` string, required
    - `name` string, required
  - `contact_id` string, nullable
  - `contact` DealContactInfo: Contact info in deal response
    - `id` string, required
    - `name` string, nullable
    - `email` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/feedback1/apis/feedback1-public-api.md) · [All operations](https://skmtc.dev/feedback1/apis/feedback1-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feedback1/apis/feedback1-public-api/revisions/e7626420f622?raw)