> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear Lead(s)

> Create one or more leads and optionally assign to a workflow. Accepts either a single lead object or an array of lead objects for bulk creation. Leads will automatically be enrolled in the workflow's cadence sequence. You can include arbitrary metadata as key-value pairs to store client-specific information about the lead. Bulk requests support up to 1000 leads per request and use partial success handling (valid leads are created even if some fail validation).

<Tip>
  **Mapeo automático de metadata**

  Cualquier clave en el cuerpo de la solicitud que **no** sea una columna principal del lead (`first_name`, `last_name`, `email`, `phone`, `source`, `company`, `title`, `city`, `date_of_birth`, `external_id`, `assigned_to`, `workflow_id`, `campaign_id`, `tags`, `force_first_message`, `force_first_channel`, `skip_first_message`) será automáticamente mapeada al objeto `metadata`. Esto significa que puedes pasar campos extra al nivel superior sin envolverlos explícitamente en `metadata`.

  Por ejemplo, enviar `{ "first_name": "Tony", "edad": 35, "broker": "Tony" }` es equivalente a `{ "first_name": "Tony", "metadata": { "edad": 35, "broker": "Tony" } }`.

  Si proporcionas tanto claves extra de nivel superior **como** un objeto `metadata`, se fusionarán, con los valores explícitos de `metadata` teniendo precedencia.
</Tip>

<Note>
  **Importar leads que ya tienen un responsable**

  Envía `assigned_to` con el ID del miembro del equipo — lo obtienes desde [GET /team](/docs/es/api/team/list-team): el campo `id` de cada miembro es el valor que debes usar. El responsable debe ser un miembro activo de tu cuenta; cualquier otro valor se rechaza con `400`.

  Asignar un responsable es independiente de `workflow_id`: `workflow_id` define qué agente de IA trabaja el lead, `assigned_to` registra qué persona es dueña de él.
</Note>


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).