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

# Create a customer

`POST /ar/customers`

Create a new customer for the organization

## Request body

- ApiV1ArCustomerCreateRequest — Request data to create a customer using the public api
  - `address` object, nullable — The address for the customer.
    - `address1` string, required — Primary street address line.
    - `address2` string, nullable — Secondary street address line (optional).
    - `city` string, required — City name.
    - `country` string, required — Two-letter country code (ISO 3166-1 alpha-2).
    - `name` string, required — The mailing name of the address.
    - `postalCode` string, required — Postal or ZIP code.
    - `region` string, required — Either a two-letter US state code i.e. "CA" for California or a free-form identification of a particular region worldwide.
  - `email` string, required — The email address for the customer.
  - `name` string, required — The name of the customer.

## Response `200`

- ApiV1ArCustomerResponseData — Response data for Accounts Receivable customer API endpoints
  - `address` object, nullable — Address of customer.
    - `address1` string, required — Primary street address line.
    - `address2` string, nullable — Secondary street address line (optional).
    - `city` string, required — City name.
    - `country` string, required — Two-letter country code (ISO 3166-1 alpha-2).
    - `postalCode` string, required — Postal or ZIP code
    - `region` string, required — State, province, or region.
  - `deletedAt` string, yyyy-mm-ddThh:MM:ssZ, nullable — The time the customer was deleted, if it was deleted.
  - `email` string, required — Email of customer.
  - `id` string, uuid, required — ArCustomerId
  - `name` string, required — Name of customer.

## Other responses

- `400` — Invalid `body`

---

[API](https://skmtc.net/mercurytechnologies/apis/mercury-api.md) · [All operations](https://skmtc.net/mercurytechnologies/apis/mercury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mercurytechnologies/mercury-api/revisions/0bdf4a496e03/schema)