# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-05-27T06:58:30.707Z

## Página

- Título: Oportunidade - Criação de novo registro.
- URL humana: https://agilize.app/docs/desenvolvedores/api/crm-lead/oportunidade/post-crm-lead-lead
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Oportunidade - Criação de novo registro.

## Seções

- Método e URL
- Autenticação
- Parâmetros
- Corpo da requisição

## Contexto técnico

- OpenAPI JSON atual: https://agilize.app/api/docs/openapi/agilize
- Referência interativa da API: https://agilize.app/docs/desenvolvedores/referencia-api
- Autenticação principal: header x-api-key
- Versão da API: 0.0.12

## Conteúdo da página

## Método e URL

```http
POST https://api.agilize.app/crm/lead/lead
```

## Autenticação

Envie a chave de API no cabeçalho da requisição.

```http
Accept: application/json
x-api-key: SUA_CHAVE_API
```

## Parâmetros

| Nome | Origem | Obrigatório | Tipo | Descrição |
| --- | --- | --- | --- | --- |
| x-api-key | header | Sim | string | Chave da API de integração gerada em seu painel gerencial. |
| content-type | header | Sim | string | application/json |

## Corpo da requisição

- Obrigatório: Sim
- Content-Type: application/json

### Campos do corpo

| Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição |
| --- | --- | --- | --- | --- |
| contacts | string[] | Não |  |  |
| automations | string[] | Não |  |  |
| companies | string[] | Não |  |  |
| phones | object[] | Não |  |  |
| emails | object[] | Não |  |  |
| socials | object[] | Não |  |  |
| name | string | Não |  | Nome descritivo |
| user | string | Não |  |  |
| createdBy | string | Não |  |  |
| import | string | Não |  | Id da importação, caso tenha sido importado |
| note | string | Não |  | Observação associada ao lead |
| stage | string | Sim |  | Estágio atual do lead no funil |
| funnel | string | Sim |  | Funil atual do lead |
| source | string | Não |  | Id de origem do lead |
| archiveReason | string | Não |  | Motivo do arquivamento |
| ticket | number | Não |  | Ticket/valor estimado desse lead |
| score | number | Não |  | Score / Temperatura |
| tags | string[] | Não |  |  |
| _ | object | Não |  |  |
| fidx1 | string | Não |  |  |
| fidx2 | string | Não |  |  |
| fidx3 | string | Não |  |  |
| dtStage | string (date-time) | Não |  | Data da última atualização de KPIs (Uso interno) |
| dueDt | string (date-time) | Não |  | Data de previsão de fechamento do lead |
| tlFinishedTasks | number | Não |  |  |
| tlTimeline | number | Não |  |  |
| pendTasks | object[] | Não |  |  |
| tlPendTasks | number | Não |  | Total de tarefas pendentes relacionadas ao lead |
| dtPendTask | string (date-time) | Não |  | Data da tarefa pendente mais próxima |
| createdAt | string (date-time) | Não |  |  |
| system_source | string | Não |  | Canal/sistema que criou o lead no CRM. Exemplos: whatsapp, calendly, webhook, facebook_lead_ads, crm_automation. Não confundir com utm.provider, que representa a origem de marketing. |
| utm | object | Não |  |  |
| utmClick | object | Não |  |  |
| transmissionList | string[] | Não |  |  |
| ip_source | string | Não |  | IP de origem do lead quando conhecido. Útil para matching técnico e integrações de conversão; não é um campo analítico principal. |
| updatedAt | string (date-time) | Não |  |  |

#### Estruturas internas

**phones**

```json
[
  {
    "phone": "string",
    "itemType": "number"
  }
]
```

**emails**

```json
[
  {
    "email": "string",
    "itemType": "number"
  }
]
```

**socials**

```json
[
  {
    "link": "string",
    "itemType": "number"
  }
]
```

**pendTasks**

```json
[
  {
    "dt": "string (date-time)"
  }
]
```

**utm**

```json
{
  "provider": "string",
  "source": "string",
  "medium": "string",
  "clickId": "string",
  "campaignId": "string",
  "campaign": "string",
  "groupId": "string",
  "group": "string",
  "creativeId": "string",
  "creative": "string",
  "content": "string",
  "term": "string",
  "url": "string",
  "ref": "string"
}
```

**utmClick**

```json
{
  "fbclid": "string",
  "ctwaClid": "string",
  "gclid": "string",
  "gbraid": "string",
  "wbraid": "string",
  "ttclid": "string"
}
```

Exemplo básico:

```json
{
  "stage": "SUBSTITUA_PELO_ID_DA_ETAPA",
  "funnel": "SUBSTITUA_PELO_ID_DO_FUNIL",
  "name": "Lead de teste",
  "emails": [
    {
      "email": "lead.teste@exemplo.com"
    }
  ],
  "phones": [
    {
      "phone": "+5511999999999"
    }
  ]
}
```

## Respostas

| Status | Descrição | Conteúdo |
| --- | --- | --- |
| 201 | created | application/json |
| 401 | not authenticated |  |
| 500 | general error |  |

## Testar requisição

Preencha os parâmetros, informe a chave no cabeçalho `x-api-key` e envie a requisição diretamente pelo navegador.