---
title: "Changes to Create customer"
method: POST
path: "/api/v1/customers"
---

# Changes to Create customer

`POST /api/v1/customers`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 9 revisions.

- **2026-07-07** `a3b4750a505f` — 2 breaking, 12 info
- **2026-07-07** `84194c31ab85` — 18 breaking, 5 warning, 4 info

## Changes

- **2026-07-07** `a3b4750a505f` — 2 breaking, 12 info
  - added the new required request property `name`
  - the `document` request property type/format changed from `object`/`` to `string`/``
  - added the new optional request property `email`
  - added the new optional request property `phone`
  - added the required property `birth_date` to the response with the `201` status
  - added the required property `created_at` to the response with the `201` status
  - added the required property `document` to the response with the `201` status
  - added the required property `email` to the response with the `201` status
  - added the required property `id` to the response with the `201` status
  - added the required property `metadata` to the response with the `201` status
  - added the required property `name` to the response with the `201` status
  - added the required property `phone` to the response with the `201` status
  - added the required property `type` to the response with the `201` status
  - added the required property `updated_at` to the response with the `201` status
- **2026-07-07** `84194c31ab85` — 18 breaking, 5 warning, 4 info
  - the `document` request property type/format changed from `string`/`` to `object`/``
  - removed the required property `avg_ticket` from the response with the `201` status
  - removed the required property `birth_date` from the response with the `201` status
  - removed the required property `created_at` from the response with the `201` status
  - removed the required property `document` from the response with the `201` status
  - removed the required property `email` from the response with the `201` status
  - removed the required property `first_order_at` from the response with the `201` status
  - removed the required property `id` from the response with the `201` status
  - removed the required property `last_order_at` from the response with the `201` status
  - removed the required property `name` from the response with the `201` status
  - removed the required property `origin` from the response with the `201` status
  - removed the required property `phone` from the response with the `201` status
  - removed the required property `phone_is_whatsapp` from the response with the `201` status
  - removed the required property `social_name` from the response with the `201` status
  - removed the required property `total_orders` from the response with the `201` status
  - removed the required property `total_spent` from the response with the `201` status
  - removed the required property `type` from the response with the `201` status
  - removed the required property `updated_at` from the response with the `201` status
  - removed the request property `email`
  - removed the request property `name`
  - removed the request property `phone`
  - removed the request property `phone_is_whatsapp`
  - removed the request property `social_name`
  - added the new optional request property `metadata`
  - added the new optional request property `type`
  - the request property `document` became nullable
  - the request property `document` became optional

---

[Operation](https://skmtc.dev/kruzer-corp/apis/oms-api/docs/api/v1/customers/post.md) · [API](https://skmtc.dev/kruzer-corp/apis/oms-api.md) · [Page](https://skmtc.dev/kruzer-corp/apis/oms-api/changes/api/v1/customers/post)