---
title: "Create a Customer"
method: POST
path: "/v1/customers"
---

# Create a Customer

`POST /v1/customers`

This API creates a customer.

## Headers

- `Accept` string, required
- `Content-Type` string, required

## Request body

- object
  - `email` string, required — Email address of the customer. It is displayed next to the customer in the dashboard and can be used for searching and tracking.
  - `name` string — Name of the customer.
  - `description` string — An arbitrary string that you can attach to a customer. It is displayed next to the customer in the dashboard.
  - `send_email_address` string — Email address to which the invoices will be sent.
  - `cc_email_address` string — Email address to which the invoices will be sent.
  - `country` string — Customer's country name.
  - `address_1` string — The customer's address for line 1.
  - `address_2` string — The customer's address for line 2.
  - `city` string — The cutomer's city name. Can be a City/District/Suburb/Town/Village.
  - `state` string — The customer's state name. Can be State/County/Province/Region.
  - `zip` integer — The customer's ZIP code.
  - `phone` integer — The customer's phone number.

## Response `201`

201

- object
  - `data` object
    - `object` string
    - `customer_id` string
    - `name` string
    - `email` string
    - `description` string
    - `payment_overdue` unknown
    - `send_email_address` string
    - `cc_email_address` string
    - `source_id` unknown
    - `address_1` string
    - `address_2` string
    - `city` string
    - `state` string
    - `zip` integer
    - `phone` integer
    - `country` string
    - `created_at` integer
    - `updated_at` integer
    - `readable_created_at` string
    - `readable_updated_at` string
    - `invoice_prefix` string
    - `card` object
      - `data` unknown[]
        - unknown
    - `bank_account` object
      - `data` unknown[]
        - unknown
  - `meta` object
    - `include` string[]
    - `custom` unknown[]
      - unknown

## Other responses

- `422` — 422

---

[API](https://skmtc.net/payarc/apis/payarc-sandbox.md) · [All operations](https://skmtc.net/payarc/apis/payarc-sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payarc/payarc-sandbox/versions/face82bdd778/schema)