---
title: "Changes to Create a customer"
method: POST
path: "/v3/customers"
---

# Changes to Create a customer

`POST /v3/customers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `54edddceb0a5`: 28 breaking, 1 info

## Changes

- **2026-11-03** `54edddceb0a5`: 28 breaking, 1 info
  - added `#/components/schemas/CountryCode, subschema #2` to the `billingAddress/allOf[#/components/schemas/Address]/country` request property `allOf` list
  - added `#/components/schemas/CountryCode, subschema #2` to the `shippingAddress/allOf[#/components/schemas/Address]/country` request property `allOf` list
  - the request property `billingAddress/allOf[#/components/schemas/Address]/city` became required
  - the request property `billingAddress/allOf[#/components/schemas/Address]/country` became required
  - the request property `billingAddress/allOf[#/components/schemas/Address]/line1` became required
  - the request property `billingAddress/allOf[#/components/schemas/Address]/zipOrPostalCode` became required
  - the request property `shippingAddress/allOf[#/components/schemas/Address]/city` became required
  - the request property `shippingAddress/allOf[#/components/schemas/Address]/country` became required
  - the request property `shippingAddress/allOf[#/components/schemas/Address]/line1` became required
  - the request property `shippingAddress/allOf[#/components/schemas/Address]/zipOrPostalCode` became required
  - the `billingAddress/allOf[#/components/schemas/Address]/city` request property's minLength was increased from `0` to `1`
  - the `billingAddress/allOf[#/components/schemas/Address]/line1` request property's minLength was increased from `0` to `1`
  - the `billingAddress/allOf[#/components/schemas/Address]/zipOrPostalCode` request property's minLength was increased from `0` to `1`
  - the `shippingAddress/allOf[#/components/schemas/Address]/city` request property's minLength was increased from `0` to `1`
  - the `shippingAddress/allOf[#/components/schemas/Address]/line1` request property's minLength was increased from `0` to `1`
  - the `shippingAddress/allOf[#/components/schemas/Address]/zipOrPostalCode` request property's minLength was increased from `0` to `1`
  - added the pattern `^.{0,1000}$` to the request property `billingAddress/allOf[#/components/schemas/Address]/line1`
  - added the pattern `^.{0,1000}$` to the request property `shippingAddress/allOf[#/components/schemas/Address]/line1`
  - added the pattern `^.{0,100}$` to the request property `billingAddress/allOf[#/components/schemas/Address]/city`
  - added the pattern `^.{0,100}$` to the request property `billingAddress/allOf[#/components/schemas/Address]/line2`
  - added the pattern `^.{0,100}$` to the request property `billingAddress/allOf[#/components/schemas/Address]/stateOrProvince`
  - added the pattern `^.{0,100}$` to the request property `shippingAddress/allOf[#/components/schemas/Address]/city`
  - added the pattern `^.{0,100}$` to the request property `shippingAddress/allOf[#/components/schemas/Address]/line2`
  - added the pattern `^.{0,100}$` to the request property `shippingAddress/allOf[#/components/schemas/Address]/stateOrProvince`
  - added the pattern `^.{0,30}$` to the request property `billingAddress/allOf[#/components/schemas/Address]/zipOrPostalCode`
  - added the pattern `^.{0,30}$` to the request property `shippingAddress/allOf[#/components/schemas/Address]/zipOrPostalCode`
  - the `billingAddress/allOf[#/components/schemas/Address]/country` request property type changed from `string` to no type
  - the `shippingAddress/allOf[#/components/schemas/Address]/country` request property type changed from `string` to no type
  - added the optional property `relevanceScore` to the response with the `201` status

---

[Operation](https://skmtc.dev/bill/apis/bill-v3-api/docs/v3/customers/post.md) - [API](https://skmtc.dev/bill/apis/bill-v3-api.md) - [Page](https://skmtc.dev/bill/apis/bill-v3-api/changes/v3/customers/post)