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

# Create Deal

`POST /deals`

## Request

- Base URL: `https://api.nomi.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nomi.so/deals`
- Auth: none declared

Create a new deal.

## Headers

- `authorization` string, nullable

## Request body

- DealCreateRequest: Request for creating a deal.
  - `name` string, required: Name of the deal
  - `crm_provider` 'hubspot' | 'attio' | 'none': Provider of the CRM system.
  - `provider_deal_id` string, nullable: Deal ID in the provider CRM system
  - `deal_stage` string, nullable: Stage of the deal
  - `deal_amount` number, nullable: Amount of the deal
  - `deal_currency` string, nullable: Currency of the deal
  - `deal_close_date` string, date-time, nullable: Expected close date
  - `deal_owner_crm_id` string, nullable: Owner ID in the CRM system
  - `nomi_insights_json` object, nullable: Nomi-generated insights about the deal

## Response `201`

Successful Response

- DealResult: Response for deal operations.
  - `id` string, uuid, required: Deal ID
  - `name` string, required: Name of the deal
  - `organization_id` string, uuid, required: Organization ID
  - `crm_provider` 'hubspot' | 'attio' | 'none', required: Provider of the CRM system.
  - `user_id` string, uuid, nullable: User ID
  - `provider_deal_id` string, nullable: Deal ID in the provider CRM system
  - `companies_ids` string[], required: Company IDs
  - `contacts_ids` string[], required: Contact IDs
  - `deal_stage` string, nullable: Stage of the deal
  - `deal_amount` number, nullable: Amount of the deal
  - `deal_currency` string, nullable: Currency of the deal
  - `deal_close_date` string, date-time, nullable: Expected close date
  - `deal_owner_crm_id` string, nullable: Owner ID in the CRM system
  - `status` 'active' | 'archived' | 'deleted', required: Status of a CRM entity (shared across types).
  - `sync_status` 'synced' | 'pending_crm' | 'sync_failed' | 'not_synced', required: Status of the synchronization with CRM systems.
  - `last_crm_sync_timestamp` string, date-time, nullable: Timestamp of the last CRM synchronization
  - `nomi_insights_json` object, nullable: Nomi-generated insights about the deal
  - `created_at` string, date-time, required: Creation timestamp
  - `updated_at` string, date-time, required: Last update timestamp
  - `intelligence_id` string, uuid, nullable: ID of the intelligence data
  - `associated_calls` integer: Number of calls associated with this deal
  - `associated_events` integer: Number of calendar events associated with this deal

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/nomi/apis/nomi-api.md) - [All operations](https://skmtc.dev/nomi/apis/nomi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nomi/apis/nomi-api/revisions/63a2f545499c?raw)