---
title: "Import contacts into a list"
method: POST
path: "/v1/projectId/{projectId}/subscriber-lists/{id}/import"
tags: ["Subscriber Lists"]
---

# Import contacts into a list

`POST /v1/projectId/{projectId}/subscriber-lists/{id}/import`

## Request

- Base URL: `https://api.bluefox.email`
- URL: `https://api.bluefox.email/v1/projectId/{projectId}/subscriber-lists/{id}/import`
- Auth: HTTP bearer

Bulk-adds up to 1000 contacts to a list in one call, like the app's CSV import. Double opt-in is skipped: contacts 
not yet on the list are added as "active" and no verification email is sent, so only import contacts who already 
agreed to receive your emails. Contacts already on the list (with any status, including "unsubscribed") are left 
untouched and counted in alreadyOnList. Each row creates the contact if it doesn't exist yet, or updates its fields 
(name, tags, custom fields) if it does. A row that fails (invalid, suppressed, or disposable email) is reported in 
errors and does not stop the rest. API key only - a SubscriptionToken is not accepted.

## Path parameters

- `projectId` string, required
- `id` string, required

## Request body

- object
  - `contacts` object[], required
    - `email` string, required
    - `name` string
    - `tags` string[]

## Response `200`

OK

- object
  - `status` integer
  - `result` object
    - `imported` integer: Contacts added to the list as active.
    - `alreadyOnList` integer: Contacts already on the list, left untouched.
    - `errors` object[]
      - `email` string
      - `message` string

## Other responses

- `400`: Invalid request body or query - every violation found (missing/invalid/unexpected fields) is reported in one response, semicolon-separated, not just the first one hit.
- `403`: Missing or invalid API key
- `404`: Subscriber list not found

---

[API](https://skmtc.dev/bluefox/apis/bluefox-email-public-api.md) · [All operations](https://skmtc.dev/bluefox/apis/bluefox-email-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bluefox/apis/bluefox-email-public-api/revisions/fa1a0a835c7f?raw)