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

# Create a customer

`POST /businesses/{id}/customers`

## Path parameters

- `id` string, required

## Request body

- 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`

The created `Customer` object

- Customer
  - `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

---

[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)
