---
title: "Create multiple customers"
method: POST
path: "/businesses/{id}/customers/batch"
tags: ["Customers"]
---

# Create multiple customers

`POST /businesses/{id}/customers/batch`

## Path parameters

- `id` string, required

## Request body

- object
  - `customers` union[], required — An array of customer data to create
    - union
      - object
        - `email_address` string, required — The email address of the customer
        - `phone_number` string, nullable — The phone number of the customer
        - `metadata` object, nullable — Any metadata to attach to the customer
        - `full_name` string, nullable — The full name of the customer
      - object
        - `phone_number` string, required — The phone number of the customer
        - `email_address` string, nullable — The email address of the customer
        - `metadata` object, nullable — Any metadata to attach to the customer
        - `full_name` string, nullable — The full name of the customer

## Response `200`

An array of created `Customer` objects

- object
  - `customers` Customer[], required — An array of created `Customer` objects (null for entries that failed)
    - `id` string, required — The ID of the customer
    - `external_id` string, nullable, required — The external ID of the customer
    - `email_address` string, nullable, required — The email address of the customer
    - `phone_number` string, nullable, required — The phone number of the customer
    - `full_name` string, nullable, required — The full name of the customer
    - `metadata` object, required — The metadata associated with this customer
    - `unsubscribed` 'future' | 'campaign', nullable, required — The unsubscribe status of the customer
  - `errors` object[] — An array of errors
    - `message` string, required — The error message
    - `path` string, required — The path to the field that caused the error

---

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