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

# Bulk Import

> Ingest batch of contacts via background worker.

### Request Body

<ParamField body="contacts" type="array" required>
  List of contact objects containing:

  * `email` (string, required)
  * `name` (string)
  * `list_name` (string)
  * `phone` (string)
  * `company` (string)
  * `job_title` (string)
  * `linkedin_url` (string)
  * `tags` (array of strings)
  * `is_subscribed` (boolean)
  * `additional_info` (object)
</ParamField>

<ParamField body="recipient_list_ids" type="array">
  Optional: Array of list UUIDs to associate all contacts with.
</ParamField>

<RequestExample>
  ```json Request theme={null}
  {
    "contacts": [
      {
        "email": "john@domain.com",
        "name": "John Doe",
        "phone": "+1 234 567 8900",
        "company": "Acme Corp",
        "job_title": "CEO",
        "linkedin_url": "https://linkedin.com/in/johndoe",
        "tags": ["outreach", "vip"],
        "is_subscribed": false,
        "additional_info": {
          "source": "Explorium"
        }
      }
    ]
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "total": 2,
      "created": 2,
      "updated": 0,
      "skipped": 0
    },
    "message": "Contacts imported successfully via API key."
  }
  ```
</ResponseExample>