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

# Create a customer

`POST /customers/`

Creates a customer

## Request body

- CustomerWrite
  - `brand_person_id` string
  - `business_id` string, nullable
  - `dob` string, string, nullable — Birthday in YYYY-MM-DD format.
  - `first_name` string, required — First name.<br />Has a 1 to 50-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.
  - `middle_name` string — Middle name.<br />Has a 50-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.
  - `last_name` string, required — Last name.<br />Has a 2 to 50-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.
  - `ssn` string — Redacted SSN. Format: XXX-XX-9999.
  - `phone` string — Numbers only or dash-separated are acceptable
  - `phone_country_code` string — Must be a string of 1-3 digits
  - `email` string — Must be a valid email address
  - `addresses` AddressWrite[], required
    - `street` string, required — Has a 1 to 40-character limit. May only contain alphanumerics and the special characters `. , _ - #`
    - `street2` string — Has a 40-character limit, inclusive. Must start with an alphanumeric, and may only contain alphanumerics and the special characters `. , _ - #`
    - `city` string, required — Has a 2 to 40-character limit. May contain only alphanumerics, `-`, `_`,`.`, and spaces
    - `state` string, required — Has a 2-character limit for US address.<br />Has a 20-character limit for non US address.
    - `zip_code` string, required — zip code in 5-digit (12345) or 9-digit (12345-1234) format for US address.<br />Has a 2 to 20-character limit for non US address.
    - `country` string, required — ISO 3166-1 alpha-2 country code.<br />Has a 2-character limit.

## Response `201`

Successful response

- Customer
  - `customer_id` string
  - `brand_person_id` string
  - `bond_brand_id` string
  - `business_id` string, nullable
  - `dob` string, string, nullable — Birthday in YYYY-MM-DD format.
  - `first_name` string, required — First name.<br />Has a 1 to 50-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.
  - `middle_name` string — Middle name.<br />Has a 50-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.
  - `last_name` string — Last name.<br />Has a 2 to 50-character limit. Must start with an alphabet and may only contain alphabets, spaces, and apostrophes.
  - `ssn` string — Redacted SSN. Format: XXX-XX-9999.
  - `phone` string — Numbers only or dash-separated are acceptable
  - `phone_country_code` string — Must be a string of 1-3 digits
  - `email` string — Must be a valid email address
  - `addresses` Address[], required
    - `address_id` string — id for address resource
    - `address_type` 'MAILING' | 'PHYSICAL', required — Address type is one of the following : MAILING, PHYSICAL
    - `street` string, required — Has a 1 to 40-character limit. May only contain alphanumerics and the special characters `. , _ - #`
    - `street2` string — Has a 40-character limit. May only contain alphanumerics and the special characters `. , _ - #`
    - `city` string, required — Has a 2 to 40-character limit. May contain only alphanumerics, `-`, `_`,`.`, and spaces
    - `state` string, required — Has a 2-character limit for US address.<br />Has a 20-character limit for non US address.
    - `zip_code` string, required — zip code in 5-digit (12345) or 9-digit (12345-1234) format for US address.<br />Has a 2 to 20-character limit for non US address.
    - `country` string, required — ISO 3166-1 alpha-2 country code.<br />Has a 2-character limit.
    - `is_primary` boolean, required — Is Primary Address?
    - `date_created` string — Date time address was created
  - `date_created` string

---

[API](https://skmtc.net/bond/apis/customer.md) · [All operations](https://skmtc.net/bond/apis/customer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bond/customer/revisions/62f5ac53144d/schema)