--- title: "Changes to Create customer" method: POST path: "/customers" --- # Changes to Create customer `POST /customers` > Every recorded change to this operation, newest first. ## Timeline Changed in 17 of 139 revisions. - **2026-10-12** `80eb0267435c`: 2 info - **2026-10-12** `de915dc839fe`: 2 warning - **2026-10-12** `e1ac9f73d09c`: 2 info - **2026-10-12** `9b1ab5a75b5e`: 2 warning - **2026-10-12** `d663503436ad`: 2 info - **2026-10-08** `477ea6131062`: 2 info - **2026-09-01** `e1d4e27b5677`: 3 info - **2026-08-20** `562f13cf61dd`: 1 warning, 1 info - **2026-07-31** `50b7421a9690`: 1 info - **2026-07-15** `f8ecf435d25d`: 1 breaking, 4 warning, 3 info - **2026-07-09** `7d57386313c7`: 5 breaking, 16 warning, 10 info - **2026-07-09** `4b1a811c4179`: 18 breaking, 16 info - **2026-06-29** `7857ddc6e44d`: 2 info - **2026-06-03** `7adf4f33ea1a`: 1 info - **2026-05-18** `8ec2edea6b20`: 4 warning - **2026-04-06** `95af41a12111`: 8 warning, 9 info - **2026-04-04** `3d452eb9ebcc`: 1 warning, 1 info ## Changes - **2026-10-12** `80eb0267435c`: 2 info - added the new optional request property `contact_persons` - added the optional property `contact_persons` to the response with the `201` status - **2026-10-12** `de915dc839fe`: 2 warning - removed the request property `contact_persons` - removed the optional property `contact_persons` from the response with the `201` status - **2026-10-12** `e1ac9f73d09c`: 2 info - added the new optional request property `contact_persons` - added the optional property `contact_persons` to the response with the `201` status - **2026-10-12** `9b1ab5a75b5e`: 2 warning - removed the request property `contact_persons` - removed the optional property `contact_persons` from the response with the `201` status - **2026-10-12** `d663503436ad`: 2 info - added the new optional request property `contact_persons` - added the optional property `contact_persons` to the response with the `201` status - **2026-10-08** `477ea6131062`: 2 info - added the new optional request property `billing_currency` - added the optional property `billing_currency` to the response with the `201` status - **2026-09-01** `e1d4e27b5677`: 3 info - added the new optional request property `tax_rate_overrides/items/tax_behavior` - added the new optional request property `tax_treatment` - added the optional property `tax_treatment` to the response with the `201` status - **2026-08-20** `562f13cf61dd`: 1 warning, 1 info - added the new `subscription_line_item` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `subscription_line_item` enum value to the request property `integration_entity_mapping/items/entity_type` - **2026-07-31** `50b7421a9690`: 1 info - added the new optional request property `onboarding_workflow_name` - **2026-07-15** `f8ecf435d25d`: 1 breaking, 4 warning, 3 info - the request property `name` became required - the `name` request property's maxLength was set to `255` - added the new `invoice_line_item` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `not_implemented` enum value to the `code` response property for the response status `400` - added the new `not_implemented` enum value to the `code` response property for the response status `500` - added the new optional request property `contact` - added the new `invoice_line_item` enum value to the request property `integration_entity_mapping/items/entity_type` - added the optional property `contact` to the response with the `201` status - **2026-07-09** `7d57386313c7`: 5 breaking, 16 warning, 10 info - request property `integration_entity_mapping/items/entity_type` was restricted to a list of enum values - the `integration_entity_mapping/items/entity_type` request property type changed from no type to `string` - the `integrations/items/entity_type` response's property type changed from no type to `string` for status `201` - the `integrations/items/status` response's property type changed from no type to `string` for status `201` - the `status` response's property type changed from no type to `string` for status `201` - added the new `addon` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `archived` enum value to the `integrations/items/status` response property for the response status `201` - added the new `archived` enum value to the `status` response property for the response status `201` - added the new `credit_note` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `customer` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `deleted` enum value to the `integrations/items/status` response property for the response status `201` - added the new `deleted` enum value to the `status` response property for the response status `201` - added the new `invoice` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `item` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `item_price` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `payment` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `plan` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `price` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `published` enum value to the `integrations/items/status` response property for the response status `201` - added the new `published` enum value to the `status` response property for the response status `201` - added the new `subscription` enum value to the `integrations/items/entity_type` response property for the response status `201` - added the new `addon` enum value to the request property `integration_entity_mapping/items/entity_type` - added the new `credit_note` enum value to the request property `integration_entity_mapping/items/entity_type` - added the new `customer` enum value to the request property `integration_entity_mapping/items/entity_type` - added the new `invoice` enum value to the request property `integration_entity_mapping/items/entity_type` - added the new `item` enum value to the request property `integration_entity_mapping/items/entity_type` - added the new `item_price` enum value to the request property `integration_entity_mapping/items/entity_type` - added the new `payment` enum value to the request property `integration_entity_mapping/items/entity_type` - added the new `plan` enum value to the request property `integration_entity_mapping/items/entity_type` - added the new `price` enum value to the request property `integration_entity_mapping/items/entity_type` - added the new `subscription` enum value to the request property `integration_entity_mapping/items/entity_type` - **2026-07-09** `4b1a811c4179`: 18 breaking, 16 info - removed the enum value `addon` of the request property `integration_entity_mapping/items/entity_type` - removed the enum value `credit_note` of the request property `integration_entity_mapping/items/entity_type` - removed the enum value `customer` of the request property `integration_entity_mapping/items/entity_type` - removed the enum value `invoice` of the request property `integration_entity_mapping/items/entity_type` - removed the enum value `item` of the request property `integration_entity_mapping/items/entity_type` - removed the enum value `item_price` of the request property `integration_entity_mapping/items/entity_type` - removed the enum value `payment` of the request property `integration_entity_mapping/items/entity_type` - removed the enum value `plan` of the request property `integration_entity_mapping/items/entity_type` - removed the enum value `price` of the request property `integration_entity_mapping/items/entity_type` - removed the enum value `subscription` of the request property `integration_entity_mapping/items/entity_type` - the `integration_entity_mapping/items/entity_type` request property type changed from `string` to no type - the `created_at` response's property format changed from `date-time` to no format for status `201` - the `integrations/items/created_at` response's property format changed from `date-time` to no format for status `201` - the `integrations/items/entity_type` response's property type changed from `string` to no type for status `201` - the `integrations/items/status` response's property type changed from `string` to no type for status `201` - the `integrations/items/updated_at` response's property format changed from `date-time` to no format for status `201` - the `status` response's property type changed from `string` to no type for status `201` - the `updated_at` response's property format changed from `date-time` to no format for status `201` - removed the `addon` enum value from the `integrations/items/entity_type` response property for the response status `201` - removed the `archived` enum value from the `integrations/items/status` response property for the response status `201` - removed the `archived` enum value from the `status` response property for the response status `201` - removed the `credit_note` enum value from the `integrations/items/entity_type` response property for the response status `201` - removed the `customer` enum value from the `integrations/items/entity_type` response property for the response status `201` - removed the `deleted` enum value from the `integrations/items/status` response property for the response status `201` - removed the `deleted` enum value from the `status` response property for the response status `201` - removed the `invoice` enum value from the `integrations/items/entity_type` response property for the response status `201` - removed the `item` enum value from the `integrations/items/entity_type` response property for the response status `201` - removed the `item_price` enum value from the `integrations/items/entity_type` response property for the response status `201` - removed the `payment` enum value from the `integrations/items/entity_type` response property for the response status `201` - removed the `plan` enum value from the `integrations/items/entity_type` response property for the response status `201` - removed the `price` enum value from the `integrations/items/entity_type` response property for the response status `201` - removed the `published` enum value from the `integrations/items/status` response property for the response status `201` - removed the `published` enum value from the `status` response property for the response status `201` - removed the `subscription` enum value from the `integrations/items/entity_type` response property for the response status `201` - **2026-06-29** `7857ddc6e44d`: 2 info - added the new optional request property `timezone` - added the optional property `timezone` to the response with the `201` status - **2026-06-03** `7adf4f33ea1a`: 1 info - added the optional property `integrations/items/metadata` to the response with the `201` status - **2026-05-18** `8ec2edea6b20`: 4 warning - removed the optional property `details` from the response with the `400` status - removed the optional property `details` from the response with the `500` status - added the new `too_many_requests` enum value to the `code` response property for the response status `400` - added the new `too_many_requests` enum value to the `code` response property for the response status `500` - **2026-04-06** `95af41a12111`: 8 warning, 9 info - removed the request property `parent_customer_external_id` - removed the request property `parent_customer_id` - removed the optional property `error` from the response with the `400` status - removed the optional property `error` from the response with the `500` status - removed the optional property `parent_customer` from the response with the `201` status - removed the optional property `parent_customer_id` from the response with the `201` status - removed the optional property `success` from the response with the `400` status - removed the optional property `success` from the response with the `500` status - added the new optional request property `integration_entity_mapping` - added the optional property `code` to the response with the `400` status - added the optional property `code` to the response with the `500` status - added the optional property `details` to the response with the `400` status - added the optional property `details` to the response with the `500` status - added the optional property `http_status_code` to the response with the `400` status - added the optional property `http_status_code` to the response with the `500` status - added the optional property `message` to the response with the `400` status - added the optional property `message` to the response with the `500` status - **2026-04-04** `3d452eb9ebcc`: 1 warning, 1 info - removed the request property `integration_entity_mapping` - added the optional property `integrations` to the response with the `201` status --- [Operation](https://skmtc.dev/flexprice/apis/flexprice-api/docs/customers/post.md) - [API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [Page](https://skmtc.dev/flexprice/apis/flexprice-api/changes/customers/post)