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

# Lead lists import

## POST /api/v1/public/lead-lists/:list\_id/import/

Import leads into a lead list.

Auth: `X-API-Key`

Body

```json theme={null}
{
  "leads": [
    {
      "first_name": "Alex",
      "last_name": "Doe",
      "linkedin_profile_url": "https://www.linkedin.com/in/alex-doe/",
      "profile_picture_url": "https://example.com/alex.jpg",
      "job_title": "Head of Sales",
      "industry": "SaaS",
      "email": "alex@example.com",
      "phone_number": "+1 555 0100",
      "location": "Amsterdam, NL",
      "custom_fields": { "plan": "pro" },
      "company_name": "Acme Inc",
      "company_industry": "Software",
      "company_linkedin_url": "https://www.linkedin.com/company/acme/",
      "company_website_url": "https://acme.com",
      "company_location": "Amsterdam, NL"
    }
  ]
}
```

Fields

* Array name: `leads`
* **first\_name** (required)
* **last\_name** (required)
* **linkedin\_profile\_url** (required)
* **profile\_picture\_url** (optional)
* **job\_title** (optional)
* **industry** (optional)
* **email** (optional)
* **phone\_number** (optional)
* **location** (optional)
* **custom\_fields** (optional JSON object)
* **company\_name** (optional)
* **company\_industry** (optional)
* **company\_linkedin\_url** (optional)
* **company\_website\_url** (optional)
* **company\_location** (optional)

Notes

* You can also send a nested `company` object with keys `name`, `website_url`, `linkedin_url`, `industry`, `location` instead of the flattened `company_*` fields. The API accepts either format.