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

# Changes to Create a customer

`POST /customers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 34 revisions.

- **2024-03-18** `3135bb8c67b3`: 1 info
- **2024-03-01** `6fb940b0dad9`: 3 breaking, 1 warning, 8 info
- **2023-12-21** `dbff52f9d224`: 1 info
- **2023-11-30** `b3351be4b462`: 1 warning
- **2023-11-03** `a6c96c5ec06e`: 7 info
- **2023-09-25** `ae3b70608528`: 4 info
- **2023-09-07** `cfabb13f9886`: 1 breaking, 2 info
- **2023-09-02** `6b13f6f47735`: 6 breaking, 14 warning, 4 info

## Changes

- **2024-03-18** `3135bb8c67b3`: 1 info
  - added the optional property `account/netTermDays` to the response with the `201` status
- **2024-03-01** `6fb940b0dad9`: 3 breaking, 1 warning, 8 info
  - the response property `account/invoiceCurrency` became optional for the status `201`
  - the `account/primaryEmail` response property's maxLength was increased from `255` to `320` for the response status `201`
  - the `primaryEmail` response property's maxLength was increased from `255` to `320` for the response status `201`
  - added the new `DRAFT` enum value to the `account/status` response property for the response status `201`
  - added the new optional request property `account/status`
  - added the new optional request property `account/tags`
  - the `account/primaryEmail` request property's maxLength was increased from `255` to `320`
  - the `primaryEmail` request property's maxLength was increased from `255` to `320`
  - added the optional property `account/tags` to the response with the `201` status
  - added the required property `account/togaiAccountId` to the response with the `201` status
  - added the required property `account/togaiCustomerId` to the response with the `201` status
  - added the required property `togaiCustomerId` to the response with the `201` status
- **2023-12-21** `dbff52f9d224`: 1 info
  - added the new optional request property `account/accountAliases`
- **2023-11-30** `b3351be4b462`: 1 warning
  - removed the optional property `account/aliases/items/status` from the response with the `201` status
- **2023-11-03** `a6c96c5ec06e`: 7 info
  - added the new optional request property `account/address/phoneNumber`
  - added the new optional request property `account/metadata`
  - added the new optional request property `address/phoneNumber`
  - added the optional property `account/address/phoneNumber` to the response with the `201` status
  - added the optional property `account/invoiceGroupDetails/billingAddress/phoneNumber` to the response with the `201` status
  - added the optional property `account/metadata` to the response with the `201` status
  - added the optional property `address/phoneNumber` to the response with the `201` status
- **2023-09-25** `ae3b70608528`: 4 info
  - added the new optional request property `account/address`
  - added the new optional request property `account/primaryEmail`
  - added the optional property `account/address` to the response with the `201` status
  - added the optional property `account/primaryEmail` to the response with the `201` status
- **2023-09-07** `cfabb13f9886`: 1 breaking, 2 info
  - removed the required property `account/invoiceGroupDetails/gracePeriod` from the response with the `201` status
  - added the required property `account/invoiceGroupDetails/email` to the response with the `201` status
  - added the required property `account/invoiceGroupDetails/name` to the response with the `201` status
- **2023-09-02** `6b13f6f47735`: 6 breaking, 14 warning, 4 info
  - the `primaryEmail` request property's maxLength was decreased to `255`
  - removed the required property `account/invoiceGroupDetails/email` from the response with the `201` status
  - removed the required property `account/invoiceGroupDetails/name` from the response with the `201` status
  - removed the required property `account/togaiAccountId` from the response with the `201` status
  - removed the required property `account/togaiCustomerId` from the response with the `201` status
  - removed the required property `togaiCustomerId` from the response with the `201` status
  - removed the request property `account/accountAliases`
  - removed the request property `account/address`
  - removed the request property `account/metadata`
  - removed the request property `account/primaryEmail`
  - removed the request property `account/status`
  - removed the request property `account/tags`
  - removed the request property `address/phoneNumber`
  - removed the optional property `account/address` from the response with the `201` status
  - removed the optional property `account/invoiceGroupDetails/billingAddress/phoneNumber` from the response with the `201` status
  - removed the optional property `account/metadata` from the response with the `201` status
  - removed the optional property `account/netTermDays` from the response with the `201` status
  - removed the optional property `account/primaryEmail` from the response with the `201` status
  - removed the optional property `account/tags` from the response with the `201` status
  - removed the optional property `address/phoneNumber` from the response with the `201` status
  - added the optional property `account/aliases/items/status` to the response with the `201` status
  - the response property `account/invoiceCurrency` became required for the status `201`
  - removed the `DRAFT` enum value from the `account/status` response property for the response status `201`
  - added the required property `account/invoiceGroupDetails/gracePeriod` to the response with the `201` status

---

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