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

# Criar lead

`POST /leads`

Cria um novo lead.

## Request body

- object — Dados do lead
  - `agentId` string, nullable — Assistente que capturou o lead
  - `name` string, nullable — Nome
  - `email` string, nullable — Email
  - `phone` string, nullable — Telefone
  - `company` string, nullable — Empresa
  - `site` string, nullable — Site
  - `custom` object — Campos
  - `utm` object — Informações de rastreamento UTM
    - `source` string, nullable — Fonte (`utm_source`)
    - `medium` string, nullable — Meio (`utm_medium`)
    - `campaign` string, nullable — Campanha (`utm_campaign`)
    - `content` string, nullable — Conteúdo (`utm_content`)
    - `term` string, nullable — Termo (`utm_term`)
  - `capture` 'completed' | 'partial' — Status da captura de dados do lead

## Response `200`

Successful response

- object — Dados do lead
  - `id` string, required — Identificador do lead
  - `agentId` string, nullable — Assistente que capturou o lead
  - `name` string, nullable — Nome
  - `email` string, nullable — Email
  - `phone` string, nullable — Telefone
  - `company` string, nullable — Empresa
  - `site` string, nullable — Site
  - `custom` object — Campos
  - `utm` object — Informações de rastreamento UTM
    - `source` string, nullable — Fonte (`utm_source`)
    - `medium` string, nullable — Meio (`utm_medium`)
    - `campaign` string, nullable — Campanha (`utm_campaign`)
    - `content` string, nullable — Conteúdo (`utm_content`)
    - `term` string, nullable — Termo (`utm_term`)
  - `capture` 'completed' | 'partial' — Status da captura de dados do lead
  - `workspaceId` string, required — Identificador do workspace associado
  - `createdAt` string, date-time — Data de criação
  - `updatedAt` string, date-time — Data da última atualização

## Other responses

- `default` — Error response

## Changes

- **2026-08-31** `0d471dab1abe` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-30T05:01:58.556Z` to `2026-08-31T00:02:54.134Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-30T05:01:58.556Z` to `2026-08-31T00:02:54.134Z` for the status `200`
- **2026-08-30** `194a2377d1f9` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-29T10:01:56.359Z` to `2026-08-30T05:01:58.556Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-29T10:01:56.359Z` to `2026-08-30T05:01:58.556Z` for the status `200`
- **2026-08-29** `174c7f1687b9` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-28T15:02:27.625Z` to `2026-08-29T10:01:56.359Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-28T15:02:27.625Z` to `2026-08-29T10:01:56.359Z` for the status `200`
- **2026-08-28** `b783f2bb0107` — 2 info
  - the `createdAt` response's property default value changed from `2026-08-27T20:04:00.495Z` to `2026-08-28T15:02:27.625Z` for the status `200`
  - the `updatedAt` response's property default value changed from `2026-08-27T20:04:00.495Z` to `2026-08-28T15:02:27.625Z` for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/rdstationmentoria/apis/agents/changes/leads/post.md)

---

[API](https://skmtc.dev/rdstationmentoria/apis/agents.md) · [All operations](https://skmtc.dev/rdstationmentoria/apis/agents/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rdstationmentoria/agents/revisions/0d471dab1abe/schema)