---
title: "Create a customer"
method: POST
path: "/v1/customers"
tags: ["Customers"]
---

# Create a customer

`POST /v1/customers`

Creates a new customer for the authenticated merchant.

## Request body

- CreateCustomerRequest — Customer details
  - `referenceId` string, required
  - `email` string, email
  - `signupAt` integer, required
  - `firstName` string
  - `middleName` string
  - `lastName` string
  - `dateOfBirth` string
  - `supportedPaymentMethods` string[]
  - `address` object
    - `line1` string
    - `line2` string
    - `city` string
    - `country` string
    - `state` string
    - `postalCode` union
      - string
      - string
  - `phoneNumber` string

## Response `200`

Success

- object — The created customer
  - `status` 'SUCCEEDED', required
  - `data` CreateCustomerResponse, required
    - `id` string, required
    - `referenceId` string, required
    - `email` string
    - `merchantId` string, required
    - `livemode` boolean, required
    - `signupAt` number, required
    - `supportedPaymentMethods` string[]
    - `supportedPayoutMethods` string[]
    - `firstName` string
    - `middleName` string
    - `lastName` string
    - `dateOfBirth` string
    - `phoneNumber` string
    - `address` object
      - `line1` string
      - `line2` string
      - `city` string
      - `state` string
      - `postalCode` string
      - `country` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

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