---
title: "Bulk add contacts to a contact list"
method: POST
path: "/v1/contact-lists/{contact_list_id}/contacts/bulk"
tags: ["Contacts"]
---

# Bulk add contacts to a contact list

`POST /v1/contact-lists/{contact_list_id}/contacts/bulk`

Add up to 1000 contacts in a single request.

## Path parameters

- `contact_list_id` integer, required

## Request body

- CreateContactsBulkRequest
  - `contacts` CreateContactRequest[], required — Array of contacts to add. Maximum 1000 per request.
    - `name` string, required — Contact's full name.
    - `phone_number` string — Primary phone number (E.164 format recommended, e.g. +14155551234).
    - `phone_number_2` string — Secondary phone number.
    - `phone_number_3` string — Tertiary phone number.
    - `contact_info` object — Arbitrary JSON metadata for the contact. Use this to store custom fields like email, address, company, or any key-value data your bot or campaign needs (e.g. `{"email": "john@example.com", "company": "Acme", "plan": "enterprise"}`).

## Response `201`

Contacts created

- object
  - `count` integer — Number of contacts created.

## Other responses

- `400` — Validation error
- `404` — Contact list not found

---

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