---
title: "Create Deal"
method: POST
path: "/v3/deals"
tags: ["Negócios"]
---

# Create Deal

`POST /v3/deals`

## Request body

- CreateDealDto
  - `_id` string, required
  - `name` string, required — Nome do negócio
  - `value` number, required — Valor em dinheiro do negócio
  - `ticketId` string — ID sequencial do ticket
  - `description` string — Descrição do ticket
  - `slaDueAt` string, date-time — Prazo de SLA do ticket
  - `lostReason` string[] — Motivos de perda
  - `productsLostReason` object[] — Motivos de perda por produto
  - `products` DealProduct[]
    - `id` string, required
    - `name` string, required
    - `price` number, required
    - `quantity` number, required
    - `discount` number, required
    - `discountType` 'percentage' | 'value', required
    - `total` number, required
  - `lostReasonObs` string — Observação de perda
  - `wonLostDate` string, date-time — Data de perda ou ganho
  - `dueDate` string, date-time — Data de vencimento
  - `status` 'open' | 'won' | 'lost', required — Status do negócio
  - `contact` DealContact
    - `id` number, required
    - `name` string, required
    - `avatar` string, required
    - `phone` string, required
    - `email` string, required
    - `createdAt` string, date-time
    - `isPrivate` boolean
  - `conversation` DealConversation
    - `id` number, required
    - `platformId` number, required
    - `lastMessageAt` string, date-time
    - `showPending` boolean, required
    - `pendingAt` string, date-time
  - `operatorId` number — ID do usuário responsável pelo negócio
  - `groupId` number — ID do grupo associado ao negócio
  - `pipelineId` string, required — ID do pipeline associado ao negócio
  - `stageId` string, required
  - `origin` string
  - `campaign` string
  - `authorType` 'user' | 'bot' | 'automation' | 'workflow' | 'unknown' | 'cadence' | 'api'
  - `authorId` object
  - `tagIds` number[]
  - `position` number
  - `focusedCounts` number
  - `tasks` object
  - `timeInStage` object
  - `lastStageChanged` string, date-time
  - `comments` number
  - `context` DealContext
    - `automationId` string
    - `importId` string
  - `customFields` object, required

## Response `201`

---

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