---
title: "Adição complexa de leads com contato e empresa"
method: POST
path: "/api/v4/leads/complex"
---

# Adição complexa de leads com contato e empresa

`POST /api/v4/leads/complex`

O método permite adicionar leads com contatos e uma empresa à sua conta em lotes. Os dados adicionados podem ser verificados no controle duplicado.

## Request body

- object
  - `RAW_BODY` object[]
    - `name` string — Nome do Lead
    - `price` number — Venda do Lead
    - `status_id` integer — ID da Etapa à qual o Lead foi adicionado, sendo a primeira etapa do pipeline principal a padrão
    - `pipeline_id` integer — ID do Pipeline ao qual o Lead foi adicionado
    - `created_by` integer — O ID do usuário que cria o Lead. Ao passar o valor 0, o lead será considerado como criado pelo robô.
    - `updated_by` integer — O ID do usuário que atualiza o Lead. Ao passar o valor 0, o lead será considerado como atualizado pelo robô.
    - `created_at` integer — A data e hora em que o lead foi criado no formato de Unix Timestamp
    - `updated_at` integer — A data e hora em que o lead foi atualizado no formato de Unix Timestamp
    - `closed_at` integer — A data e hora em que o lead foi fechado no formato de Unix Timestamp
    - `loss_reason_id` integer — ID da razão da perda
    - `responsible_user_id` integer — ID do usuário responsável pelo Lead
    - `custom_fields_values` string, json — Um array contendo informações sobre os valores dos campos personalizados especificados para este Lead
    - `_embedded` object — Entidades incorporadas do Lead
      - `tags` object[]
        - `id` integer — ID da tag
        - `name` string — Nome da tag
      - `contacts` object[] — Linked contacts data array. This array always consists of 1 element as the method accepts only one contact.
        - `id` integer — ID do Contato
        - `name` string — Nome completo do Contato
        - `first_name` string — Nome do Contato
        - `last_name` string — Sobrenome do Contato
        - `responsible_user_id` integer — ID do Usuário responsável do Contato
        - `created_by` integer — ID do Usuário que criou o Contato
        - `updated_by` string — ID do Usuário que atualizou o Contato por último
        - `created_at` integer — Data de criação do Contato no formato de Unix Timestamp
        - `updated_at` integer — Data de atualização do Contato no formato de Unix Timestamp
        - `custom_fields_values` string — Um array dos valores atuais dos campos personalizados do Contato
        - `request_id` string — O campo será retornado inalterado na resposta e não será salvo.
        - `tags_to_add` object[] — Array de tags a serem adicionadas. Você precisa passar o nome ou o ID da tag.
          - `id` integer — ID da tag
          - `name` string — Nome da tag
      - `companies` object[] — Linked company data array. This array always consists of 1 element, as a lead can have only one company linked to it.
        - `id` string — ID da Empresa
        - `name` string — Nome da Empresa
        - `responsible_user_id` integer — ID do Usuário responsável da Empresa
        - `created_by` integer — ID do Usuário que criou a Empresa
        - `updated_by` integer — ID do Usuário que atualizou a Empresa por último
        - `created_at` integer — Data de criação da Empresa no formato de Unix Timestamp
        - `updated_at` integer — Data de atualização da Empresa no formato de Unix Timestamp
        - `custom_fields_values` string, json — Um array dos valores atuais dos campos personalizados da Empresa
        - `_embedded` object[]
          - `id` integer — ID da tag
          - `name` string — Nome da tag
        - `request_id` string — O campo será retornado inalterado na resposta e não será salvo.
        - `tags_to_add` object[] — Array de tags a serem adicionadas. Você precisa passar o nome ou o ID da tag.
          - `id` integer — ID da tag
          - `name` string — Nome da tag
      - `metadata` string, json — An object containing the metadata for the entity being created in the incoming lead. If metadata is passed, we consider it to be an incoming lead, and any status passed other than the incoming lead will be ignored. The parameters are the same as those passed when creating an incoming lead, except for the need to pass an additional category key. Additionally, you need to pass "category" (sip or forms) in the object. Read more about metadata parameters: https://developers.kommo.com/reference/metadata
      - `source` object — Fonte da Lead
        - `external_id` string — O ID externo da fonte. Uma fonte pode ser adicionada usando a API de Fontes. Se o external_id da fonte for passado e o pipeline_id não for passado, o lead será adicionado ao pipeline onde a fonte está localizada.
        - `type` string — Tipo de fonte. Para leads adicionados por integrações, apenas o widget é suportado.
    - `tags_to_add` object[] — Array de tags a serem adicionadas. Você precisa passar o nome ou o ID da tag.
      - `id` integer — ID da tag
      - `name` string — Nome da tag

## Response `200`

200

- object[]
  - `id` integer
  - `contact_id` integer
  - `company_id` integer
  - `request_id` string[]
  - `merged` boolean

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo.md) · [All operations](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/referencias-de-api-da-kommo/versions/98fdf05c2f5b/schema)