---
title: "Changes to Create an account"
method: POST
path: "/accounts"
---

# Changes to Create an account

`POST /accounts`

> 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`: 2 breaking, 1 warning, 6 info
- **2023-12-21** `dbff52f9d224`: 1 info
- **2023-11-30** `b3351be4b462`: 1 warning
- **2023-11-03** `a6c96c5ec06e`: 2 breaking, 9 warning, 3 info
- **2023-09-25** `ae3b70608528`: 4 info
- **2023-09-07** `cfabb13f9886`: 1 breaking, 2 info
- **2023-09-02** `6b13f6f47735`: 8 breaking, 7 warning, 8 info

## Changes

- **2024-03-18** `3135bb8c67b3`: 1 info
  - added the optional property `netTermDays` to the response with the `201` status
- **2024-03-01** `6fb940b0dad9`: 2 breaking, 1 warning, 6 info
  - the response property `invoiceCurrency` became optional for the 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 `status` response property for the response status `201`
  - added the new optional request property `allOf[#/components/schemas/CreateAccountRequestWithoutCustomerId]/status`
  - added the new optional request property `allOf[#/components/schemas/CreateAccountRequestWithoutCustomerId]/tags`
  - the `allOf[#/components/schemas/CreateAccountRequestWithoutCustomerId]/primaryEmail` request property's maxLength was increased from `255` to `320`
  - added the optional property `tags` to the response with the `201` status
  - added the required property `togaiAccountId` 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 `allOf[#/components/schemas/CreateAccountRequestWithoutCustomerId]/accountAliases`
- **2023-11-30** `b3351be4b462`: 1 warning
  - removed the optional property `aliases/items/status` from the response with the `201` status
- **2023-11-03** `a6c96c5ec06e`: 2 breaking, 9 warning, 3 info
  - added `#/components/schemas/CreateAccountRequestWithoutCustomerId, subschema #2` to the request body `allOf` list
  - the request's body type changed from `object` to no type
  - removed the request property `address`
  - removed the request property `aliases`
  - removed the request property `customerId`
  - removed the request property `id`
  - removed the request property `invoiceCurrency`
  - removed the request property `name`
  - removed the request property `netTermDays`
  - removed the request property `primaryEmail`
  - removed the request property `settings`
  - added the optional property `address/phoneNumber` to the response with the `201` status
  - added the optional property `invoiceGroupDetails/billingAddress/phoneNumber` to the response with the `201` status
  - added the optional property `metadata` to the response with the `201` status
- **2023-09-25** `ae3b70608528`: 4 info
  - added the new optional request property `address`
  - added the new optional request property `primaryEmail`
  - added the optional property `address` to the response with the `201` status
  - added the optional property `primaryEmail` to the response with the `201` status
- **2023-09-07** `cfabb13f9886`: 1 breaking, 2 info
  - removed the required property `invoiceGroupDetails/gracePeriod` from the response with the `201` status
  - added the required property `invoiceGroupDetails/email` to the response with the `201` status
  - added the required property `invoiceGroupDetails/name` to the response with the `201` status
- **2023-09-02** `6b13f6f47735`: 8 breaking, 7 warning, 8 info
  - added the new required request property `customerId`
  - added the new required request property `id`
  - added the new required request property `name`
  - the request's body type changed from no type to `object`
  - removed the required property `invoiceGroupDetails/email` from the response with the `201` status
  - removed the required property `invoiceGroupDetails/name` from the response with the `201` status
  - removed the required property `togaiAccountId` from the response with the `201` status
  - removed the required property `togaiCustomerId` from the response with the `201` status
  - removed `#/components/schemas/CreateAccountRequestWithoutCustomerId, subschema #2` from the request body `allOf` list
  - removed the optional property `address` from the response with the `201` status
  - removed the optional property `invoiceGroupDetails/billingAddress/phoneNumber` from the response with the `201` status
  - removed the optional property `metadata` from the response with the `201` status
  - removed the optional property `netTermDays` from the response with the `201` status
  - removed the optional property `primaryEmail` from the response with the `201` status
  - removed the optional property `tags` from the response with the `201` status
  - added the new optional request property `aliases`
  - added the new optional request property `invoiceCurrency`
  - added the new optional request property `netTermDays`
  - added the new optional request property `settings`
  - added the optional property `aliases/items/status` to the response with the `201` status
  - the response property `invoiceCurrency` became required for the status `201`
  - removed the `DRAFT` enum value from the `status` response property for the response status `201`
  - added the required property `invoiceGroupDetails/gracePeriod` to the response with the `201` status

---

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