---
title: "Changes to Create a Customer"
method: POST
path: "/v1/customers"
---

# Changes to Create a Customer

`POST /v1/customers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `f9ffaecbfe3d`: 2 breaking, 2 warning, 9 info

## Changes

- **2026-11-03** `f9ffaecbfe3d`: 2 breaking, 2 warning, 9 info
  - removed the enum value `email` of the request property `data/attributes/default_device`
  - removed the enum value `phone` of the request property `data/attributes/default_device`
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `errors` from the response with the `400` status
  - api operation id `create_customers` removed and replaced with `create-a-customer`
  - the endpoint scheme security `BasicAuth` was removed from the API
  - api tag `Customers (v1)` removed
  - added the new optional request property `data/attributes/metadata`
  - request body became optional
  - the request property `data` became optional
  - the request property `data/attributes` became optional
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `500`

---

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