---
title: "Criar lead"
method: POST
path: "/leads"
tags: ["crm-v2-leads"]
---

# Criar lead

`POST /leads`

## Request

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

Cria um lead. Se `stage_id` for omitido, o lead é associado à primeira etapa do funil da conta.
`rating` assume `1` e `status` assume `ongoing` quando omitidos. Na criação, `status` só aceita `ongoing`.

## Erros comuns

* **422**: payload inválido (ex.: `name` fora de 2–255 caracteres, `rating` fora de 1–5, `status` diferente de `ongoing`, ID inválido, `name` ou `owner_id` ausentes).
* **422**: `stage_id` ausente e a conta não tem etapa inicial para o preenchimento automático.
* **404**: etapa, fonte, campanha, empresa, contato ou responsável não encontrados na conta.

## Request body

- object
  - `data` object: Dados do recurso relacionado.
    - `id` string: Identificador único.
    - `name` string: Nome do lead. Obrigatório na criação. Mínimo de 2 e máximo de 255 caracteres.
    - `status` 'ongoing' | 'converted' | 'discarded': Status do lead. Na criação, somente `ongoing` (padrão). Valores: `ongoing`, `converted`, `discarded`.
    - `rating` integer: Qualificação do lead, de 1 a 5. Padrão `1`.
    - `stage_id` string: ID da etapa do lead. Na criação, se omitido, o lead é associado à primeira etapa do funil.
    - `source_id` string: ID da fonte do lead.
    - `campaign_id` string: ID da campanha associada ao lead.
    - `organization_id` string: ID da empresa associada ao lead.
    - `contact_ids` string[]: IDs dos contatos vinculados ao lead. Todos devem existir na conta.
    - `owner_id` string: ID do usuário responsável pelo lead. Obrigatório na criação.
    - `created_at` string, date-time: Data de criação do lead.
    - `updated_at` string, date-time: Data de atualização do lead.

## Response `201`

Created

- object
  - `data` object: Dados do recurso relacionado.
    - `id` string: Identificador único.
    - `name` string: Nome do lead. Obrigatório na criação. Mínimo de 2 e máximo de 255 caracteres.
    - `status` 'ongoing' | 'converted' | 'discarded': Status do lead. Na criação, somente `ongoing` (padrão). Valores: `ongoing`, `converted`, `discarded`.
    - `rating` integer: Qualificação do lead, de 1 a 5. Padrão `1`.
    - `stage_id` string: ID da etapa do lead. Na criação, se omitido, o lead é associado à primeira etapa do funil.
    - `source_id` string: ID da fonte do lead.
    - `campaign_id` string: ID da campanha associada ao lead.
    - `organization_id` string: ID da empresa associada ao lead.
    - `contact_ids` string[]: IDs dos contatos vinculados ao lead. Todos devem existir na conta.
    - `owner_id` string: ID do usuário responsável pelo lead. Obrigatório na criação.
    - `created_at` string, date-time: Data de criação do lead.
    - `updated_at` string, date-time: Data de atualização do lead.

## 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.
- `404`: O recurso solicitado não existe.
- `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)