---
title: "Añadir leads"
method: POST
path: "/api/v4/leads"
---

# Añadir leads

`POST /api/v4/leads`

Este método permite añadir varios o un solo lead a la cuenta.

## Request body

- object
  - `RAW_BODY` object[]
    - `name` string — Nombre del lead
    - `price` number — Venta del lead
    - `status_id` integer — ID de la etapa a la que se añade el lead. Por defecto, es la primera etapa del pipeline principal.
    - `pipeline_id` integer — ID del pipeline al que se añade el lead.
    - `created_by` integer — El ID del usuario que crea el lead. Al pasar el valor 0, el lead será considerado como creado por el robot.
    - `updated_by` integer — El ID del usuario que actualiza el lead. Al pasar el valor 0, el lead será considerado como creado por el robot.
    - `created_at` integer — Fecha de creación del lead en formato de Unix Timestamp.
    - `updated_at` integer — Fecha de actualización del lead en formato de Unix Timestamp.
    - `closed_at` integer — Fecha de cierre del lead en formato de Unix Timestamp.
    - `loss_reason_id` integer — ID del motivo de pérdida del lead.
    - `responsible_user_id` integer — ID del usuario responsable del lead.
    - `custom_fields_values` string, json — Un arreglo de los valores actuales de los campos personalizados del lead.
    - `_embedded` object — Entidades asociadas del lead.
      - `tags` object[] — Etiquetas vinculadas al lead
        - `id` integer — ID de la etiqueta.
        - `name` string — Nombre de la etiqueta.
      - `contacts` object[] — Contactos vinculados al lead
        - `id` integer — ID del contacto
        - `is_main` boolean — Indica si el contacto es principal o no
      - `companies` object[] — Compañía vinculada al lead. Puedes asignar solo 1 compañía
        - `id` integer — ID de la compañía
      - `source` object — Fuente del lead.
        - `external_id` string — ID externo de la fuente. Una fuente puede ser añadida utilizando la API de Fuentes. Si se pasa el external_id de la fuente y no se pasa el pipeline_id, el lead se añadirá al pipeline donde se encuentra la fuente.
        - `type` string — Tipo de fuente. Para leads añadidos por integraciones, solo se admite el widget.
    - `tags_to_add` object[] — Arreglo de etiquetas para añadir Debes pasar ya sea el nombre o el ID de la etiqueta.
      - `id` integer — ID de la etiqueta.
      - `name` string — Nombre de la etiqueta.

## Response `200`

200

- object
  - `_links` object
    - `self` object
      - `href` string
  - `_embedded` object
    - `leads` object[]
      - `id` integer
      - `request_id` string
      - `_links` object
        - `self` object
          - `href` string

## Other responses

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

---

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