---
title: "Criar negociação"
method: POST
path: "/deals"
tags: ["crm-v2-deals"]
---

# Criar negociação

`POST /deals`

## Request

- Base URL: `https://api.rd.services/crm/v2`
- URL: `https://api.rd.services/crm/v2/deals`
- Auth: OAuth 2
  - Authorization code: `/oauth/authorize`
  - Token URL: `/oauth/token`

Este end-point permite a criação de uma nova negociação no RD Station CRM. É o ponto de partida para automatizar a entrada de novas oportunidades de venda, seja a partir de um formulário no site, de outro sistema ou de um evento de marketing.

**Importante**: Somente é permitido criar negociações com status `ongoing`.

## Request body

- object
  - `data` object: Dados do recurso relacionado.
    - `id` string: Identificador único.
    - `name` string: Nome da negociação.
    - `recurrence_price` number, float: Valor recorrente da negociação.
    - `one_time_price` number, float: Valor único da negociação.
    - `total_price` number, float: Valor total da negociação.
    - `expected_close_date` string, date: Data de previsão de fechamento da negociação.
    - `rating` integer: Qualificação da negociação.
    - `status` 'won' | 'lost' | 'ongoing' | 'paused': Status da negociação.
    - `closed_at` string, date-time: Data de fechamento da negociação.
    - `pipeline_id` string: ID do funil de vendas da negociação.
    - `stage_id` string: ID da etapa do funil de vendas da negociação.
    - `owner_id` string: ID do usuário responsável pela negociação.
    - `source_id` string: ID da fonte da negociação.
    - `campaign_id` string: ID da campanha da negociação.
    - `lost_reason_id` string: ID do motivo de perda da negociação.
    - `organization_id` string: ID da empresa associada à negociação.
    - `contact_ids` string[]: IDs dos contatos associados à negociação.
    - `custom_fields` CustomFields
    - `distribution_settings` DistributionSetting
      - `stage_id` string: ID da etapa do funil de vendas da negociação.
      - `rule` object: Configurações para seleção do usuário para receber a negociação.
        - `type` 'user' | 'team' | 'all' | 'all_users' | 'all_admins' | 'owner': Tipo de distribuição.
        - `id` string: Identificador do time ou usuário para distribuição da negociação.
        - `email` string: Email do usuário para distribuir a negociação.
    - `created_at` string, date-time: Data de criação da negociação.
    - `updated_at` string, date-time: Data de atualização da negociação.

## Response `201`

Created

- object
  - `data` object: Dados do recurso relacionado.
    - `id` string: Identificador único.
    - `name` string: Nome da negociação.
    - `recurrence_price` number, float: Valor recorrente da negociação.
    - `one_time_price` number, float: Valor único da negociação.
    - `total_price` number, float: Valor total da negociação.
    - `expected_close_date` string, date: Data de previsão de fechamento da negociação.
    - `rating` integer: Qualificação da negociação.
    - `status` 'won' | 'lost' | 'ongoing' | 'paused': Status da negociação.
    - `closed_at` string, date-time: Data de fechamento da negociação.
    - `pipeline_id` string: ID do funil de vendas da negociação.
    - `stage_id` string: ID da etapa do funil de vendas da negociação.
    - `owner_id` string: ID do usuário responsável pela negociação.
    - `source_id` string: ID da fonte da negociação.
    - `campaign_id` string: ID da campanha da negociação.
    - `lost_reason_id` string: ID do motivo de perda da negociação.
    - `organization_id` string: ID da empresa associada à negociação.
    - `contact_ids` string[]: IDs dos contatos associados à negociação.
    - `custom_fields` CustomFields
    - `distribution_settings` DistributionSetting
      - `stage_id` string: ID da etapa do funil de vendas da negociação.
      - `rule` object: Configurações para seleção do usuário para receber a negociação.
        - `type` 'user' | 'team' | 'all' | 'all_users' | 'all_admins' | 'owner': Tipo de distribuição.
        - `id` string: Identificador do time ou usuário para distribuição da negociação.
        - `email` string: Email do usuário para distribuir a negociação.
    - `created_at` string, date-time: Data de criação da negociação.
    - `updated_at` string, date-time: Data de atualização da negociação.

## Other responses

- `400`: A requisição está malformada e não consegue ser processada.
- `401`: O token da API está ausente ou inválido.
- `403`: O token não tem permissão para acessar o recurso solicitado.
- `422`: A entidade não pode ser processada.
- `429`: O limite de requisições foi excedido.
- `500`: Erro interno ou inesperado no servidor.

---

[API](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/revisions/10d0a25b8c54?raw)