---
title: "Batch import contacts"
method: POST
path: "/contacts/batch"
tags: ["Contacts"]
---

# Batch import contacts

`POST /contacts/batch`

Import up to 1,000 contacts in a single request. Creates new contacts or updates existing ones.

## Request body

- object
  - `contacts` object[], required
    - `email` string, email, required
    - `first_name` string
    - `last_name` string
    - `lists` integer[]

## Response `200`

Batch import results

- BatchResult
  - `created` integer
  - `updated` integer

## Other responses

- `402` — Contact limit would be exceeded
- `422` — Validation error

---

[API](https://skmtc.net/sendfox/apis/sendfox-api.md) · [All operations](https://skmtc.net/sendfox/apis/sendfox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendfox/sendfox-api/revisions/c5728da3037f/schema)