> ## 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.

# Create 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>
  **Automatic metadata mapping**

  Any keys in the request body that are **not** core lead columns (`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`) will automatically be mapped into the `metadata` object. This means you can pass extra fields at the top level without explicitly wrapping them in `metadata`.

  For example, sending `{ "first_name": "Tony", "edad": 35, "broker": "Tony" }` is equivalent to `{ "first_name": "Tony", "metadata": { "edad": 35, "broker": "Tony" } }`.

  If you provide both top-level extra keys **and** a `metadata` object, they will be merged, with explicit `metadata` values taking precedence.
</Tip>

<Note>
  **Importing leads that already have an owner**

  Send `assigned_to` with the team member's user ID — get it from [GET /team](/docs/en/api/team/list-team), where each member's `id` is the value to use. The owner must be an active member of your account; anything else is rejected with `400`.

  Assigning an owner is independent from `workflow_id`: `workflow_id` picks the AI agent that works the lead, `assigned_to` records which person owns it.
</Note>


## API Specification

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