---
title: "Changes to Create a new customer"
method: POST
path: "/v1/sdk/customers"
---

# Changes to Create a new customer

`POST /v1/sdk/customers`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 9 of 27 revisions.

- **2026-07-30** `8578b7536a9f` — 1 info
- **2026-07-17** `bbc2ff2bc849` — 2 breaking, 2 warning, 2 info
- **2026-04-26** `60c2cd1caf83` — 1 breaking
- **2026-04-10** `c6f97c4a5492` — 1 breaking
- **2026-04-08** `052cc028fdfa` — 1 info
- **2026-04-07** `d69c95d790d2` — 1 warning, 1 info
- **2026-04-04** `88abf6f50f11` — 2 breaking, 3 info
- **2026-03-14** `0e1cded2ee5d` — 1 breaking, 2 info
- **2026-02-27** `9079f361f51c` — 1 info

## Changes

- **2026-07-30** `8578b7536a9f` — 1 info
  - the request property `metadata` became optional
- **2026-07-17** `bbc2ff2bc849` — 2 breaking, 2 warning, 2 info
  - added the pattern `^[\p{L}\p{N} .,'"&\/()+:\-]*$` to the request property `name`
  - the `telephone` request property type/format changed from `string`/`` to ``/``
  - the `externalRef` request property's maxLength was set to `50`
  - the `name` request property's maxLength was set to `100`
  - added the new optional request property `description`
  - added `subschema #1, subschema #2` to the `telephone` request property `oneOf` list
- **2026-04-26** `60c2cd1caf83` — 1 breaking
  - the response's body type/format changed from `object`/`` to ``/`` for status `400`
- **2026-04-10** `c6f97c4a5492` — 1 breaking
  - the response's body type/format changed from ``/`` to `object`/`` for status `400`
- **2026-04-08** `052cc028fdfa` — 1 info
  - added the optional property `purchases/items/planRef` to the response with the `201` status
- **2026-04-07** `d69c95d790d2` — 1 warning, 1 info
  - removed the optional property `purchases/items/productReference` from the response with the `201` status
  - added the optional property `purchases/items/productRef` to the response with the `201` status
- **2026-04-04** `88abf6f50f11` — 2 breaking, 3 info
  - added the new required request property `metadata`
  - the `email` request property type/format changed from `string`/`` to `string`/`email`
  - added the new optional request property `telephone`
  - added the optional property `purchases/items/exchangeRate` to the response with the `201` status
  - added the optional property `purchases/items/originalAmount` to the response with the `201` status
- **2026-03-14** `0e1cded2ee5d` — 1 breaking, 2 info
  - removed the required property `purchases/items/planName` from the response with the `201` status
  - added the optional property `purchases/items/planSnapshot` to the response with the `201` status
  - added the required property `purchases/items/productName` to the response with the `201` status
- **2026-02-27** `9079f361f51c` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/solvapay/apis/solvapay-rest-api/docs/v1/sdk/customers/post.md) · [API](https://skmtc.dev/solvapay/apis/solvapay-rest-api.md) · [Page](https://skmtc.dev/solvapay/apis/solvapay-rest-api/changes/v1/sdk/customers/post)