---
title: "Changes to Create a customer"
method: POST
path: "/v0.1/customers"
---

# Changes to Create a customer

`POST /v0.1/customers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 79 revisions.

- **2026-07-10** `c75ca16e1e44`: 1 info
- **2026-04-13** `d06724d996eb`: 3 info
- **2026-03-11** `cd79d83b07e0`: 2 warning, 6 info
- **2025-12-15** `1cc3dc13341a`: 1 breaking
- **2025-03-29** `040271b0b0c2`: 1 breaking, 6 warning, 9 info
- **2025-02-25** `cdadac3315a1`: 2 info

## Changes

- **2026-07-10** `c75ca16e1e44`: 1 info
  - the security scope `customers.write` was added to the endpoint's security scheme `oauth2`
- **2026-04-13** `d06724d996eb`: 3 info
  - the response property `oneOf[subschema #2]/error_code` became required for the status `400`
  - the response property `oneOf[subschema #2]/error_message` became required for the status `400`
  - the response property `oneOf[subschema #2]/instance` became required for the status `400`
- **2026-03-11** `cd79d83b07e0`: 2 warning, 6 info
  - removed the optional property `error_code` from the response with the `401` status
  - removed the optional property `message` from the response with the `401` status
  - added the non-success response with the status `400`
  - added the optional property `detail` to the response with the `401` status
  - added the optional property `instance` to the response with the `401` status
  - added the optional property `status` to the response with the `401` status
  - added the optional property `title` to the response with the `401` status
  - added the required property `type` to the response with the `401` status
- **2025-12-15** `1cc3dc13341a`: 1 breaking
  - request body became required
- **2025-03-29** `040271b0b0c2`: 1 breaking, 6 warning, 9 info
  - the response property `personal_details/address/country` became optional for the status `201`
  - removed the request property `personal_details/address/line1`
  - removed the request property `personal_details/address/line2`
  - removed the request property `personal_details/birthdate`
  - removed the optional property `personal_details/address/line1` from the response with the `201` status
  - removed the optional property `personal_details/address/line2` from the response with the `201` status
  - removed the optional property `personal_details/birthdate` from the response with the `201` status
  - added the new optional request property `personal_details/address/line_1`
  - added the new optional request property `personal_details/address/line_2`
  - added the new optional request property `personal_details/birth_date`
  - added the new optional request property `personal_details/tax_id`
  - the request property `personal_details/address/country` became optional
  - added the optional property `personal_details/address/line_1` to the response with the `201` status
  - added the optional property `personal_details/address/line_2` to the response with the `201` status
  - added the optional property `personal_details/birth_date` to the response with the `201` status
  - added the optional property `personal_details/tax_id` to the response with the `201` status
- **2025-02-25** `cdadac3315a1`: 2 info
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `oauth2` was added to the API

---

[Operation](https://skmtc.dev/sumup/apis/sumup-rest-api/docs/v0.1/customers/post.md) - [API](https://skmtc.dev/sumup/apis/sumup-rest-api.md) - [Page](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v0.1/customers/post)