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

# Create Deal

`POST /deal`

Create a new deal

## Query parameters

- `select` string

## Request body

- Deal
  - `id` string, uuid
  - `created_at` string, timestamp with time zone
  - `updated_at` string, timestamp with time zone — Latest update
  - `organisation_id` string, uuid — Organisation ID
  - `contact_id` string, uuid — Contact ID
  - `name` string, text — Name of the deal
  - `external_id` string, text, nullable — External ID
  - `type_key` string, text — Type Key
  - `status_key` string, text — Status Key
  - `assignee_id` string, uuid, nullable — Assignee ID
  - `value` number, nullable — Value of the deal
  - `currency` 'EUR' | 'CHF' | 'USD', public.currency — Currency of the deal
  - `won_at` string, timestamp with time zone, nullable — Won at timestamp
  - `lost_at` string, timestamp with time zone, nullable — Lost at timestamp

## Response `200`

The updated Deal object

- Deal
  - `id` string, uuid
  - `created_at` string, timestamp with time zone
  - `updated_at` string, timestamp with time zone — Latest update
  - `organisation_id` string, uuid — Organisation ID
  - `contact_id` string, uuid — Contact ID
  - `name` string, text — Name of the deal
  - `external_id` string, text, nullable — External ID
  - `type_key` string, text — Type Key
  - `status_key` string, text — Status Key
  - `assignee_id` string, uuid, nullable — Assignee ID
  - `value` number, nullable — Value of the deal
  - `currency` 'EUR' | 'CHF' | 'USD', public.currency — Currency of the deal
  - `won_at` string, timestamp with time zone, nullable — Won at timestamp
  - `lost_at` string, timestamp with time zone, nullable — Lost at timestamp

## Other responses

- `201` — The Deal was created
- `204` — No Content

---

[API](https://skmtc.dev/getmateo/apis/mateo-api.md) · [All operations](https://skmtc.dev/getmateo/apis/mateo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getmateo/mateo-api/revisions/22a9b3b009d1/schema)