---
title: "Bulk create subscribers"
method: POST
path: "/subscribers_bulk_create"
tags: ["subscribers"]
---

# Bulk create subscribers

`POST /subscribers_bulk_create`

Creates one or more subscriber records. Adds to subscription list if specified, otherwise adds to all contacts.

## Request body

- BulkCreateSubscribersRequest
  - `subscribers` BulkCreateSubscribersRequestSubscribers[] — Array of subscribers to create
    - `email` string, email, required — Subscriber's email address (required)
    - `first_name` string — Subscriber's first name
    - `last_name` string — Subscriber's last name
    - `custom_fields` object[] — Optional custom fields (unlimited)
  - `subscription_list_id` string — Optional subscription list ID

## Response `200`

Subscribers created successfully

- BulkCreateResponse
  - `data` BulkCreateResponseData
    - `num_subscribers_added` integer — Number of subscribers successfully added

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `422` — Unprocessable entity
- `500` — Internal server error

---

[API](https://skmtc.dev/paubox/apis/paubox-forms-api.md) · [All operations](https://skmtc.dev/paubox/apis/paubox-forms-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/paubox/paubox-forms-api/revisions/71f6affe238c/schema)