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

# Create a deal

`POST /crm/deals`

## Request body

- Body8
  - `name` string, required — Name of deal
  - `attributes` object — Attributes for deal creation To assign owner of a Deal you can send attributes.deal_owner and utilize the account email or ID. If you want to create a deal on a specific pipeline and stage you can use the following attributes `pipeline` and `deal_stage`. Pipeline and deal_stage are ids you can fetch using this endpoint `/crm/pipeline/details/{pipelineID}`
  - `linkedContactsIds` integer[] — Contact ids to be linked with deal
  - `linkedCompaniesIds` string[] — Company ids to be linked with deal

## Response `201`

Created new Deal

- InlineResponse2011 — Created deal id
  - `id` string, required — Unique deal id

## Other responses

- `400` — Returned when invalid data posted

---

[API](https://skmtc.net/getbrevo/apis/brevo-api.md) · [All operations](https://skmtc.net/getbrevo/apis/brevo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbrevo/brevo-api/versions/2aec3cf66501/schema)