---
title: "Changes to Create an address for a customer"
method: POST
path: "/customers/{customer_id}/addresses"
---

# Changes to Create an address for a customer

`POST /customers/{customer_id}/addresses`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 19 revisions.

- **2026-10-19** (v1) `4f35a8c6ea4d`: 1 breaking, 1 info
- **2026-07-09** (v1) `e1ac347eb3c5`: 1 breaking
- **2026-02-02** (v1) `9ba8be0f2006`: 35 breaking, 1 warning, 49 info
- **2025-03-07** (v1) `a3359d7731fd`: 7 breaking, 5 info
- **2024-12-06** (v1) `274e5b2be190`: 232 breaking, 230 info
- **2024-05-14** (v1) `61fe84bfd516`: 1 info
- **2024-02-19** (v1) `a4a4068ff792`: 7 breaking, 1 warning, 6 info

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 1 breaking, 1 info
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/country_code/allOf[#/components/schemas/CountryCode]/` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/CountryCodeNonSupported` to the `country_code/allOf[#/components/schemas/CountryCode]/` request property `oneOf` list
- **2026-07-09** (v1) `e1ac347eb3c5`: 1 breaking
  - added the pattern `^ctm_[a-z\d]{26}$` to the `path` request parameter `customer_id`
- **2026-02-02** (v1) `9ba8be0f2006`: 35 breaking, 1 warning, 49 info
  - added the new path request parameter `customer_id`
  - request body became required
  - added `#/components/schemas/AddressId` to the `id` request property `allOf` list
  - added `#/components/schemas/CountryCode` to the `country_code` request property `allOf` list
  - the request property `city` became not nullable
  - the request property `description` became not nullable
  - the request property `first_line` became not nullable
  - the request property `postal_code` became not nullable
  - the request property `region` became not nullable
  - the request property `second_line` became not nullable
  - removed `#/components/schemas/country_code_supported` from the `country_code` request property `oneOf` list
  - removed `#/components/schemas/custom_data, subschema #2` from the `custom_data` request property `oneOf` list
  - removed `#/components/schemas/import_meta, subschema #2` from the `import_meta` request property `oneOf` list
  - the `data/city` response property's maxLength was unset from `200` for the response status `201`
  - the `data/description` response property's maxLength was unset from `1024` for the response status `201`
  - the `data/first_line` response property's maxLength was unset from `1024` for the response status `201`
  - the `data/postal_code` response property's maxLength was unset from `200` for the response status `201`
  - the `data/region` response property's maxLength was unset from `200` for the response status `201`
  - the `data/second_line` response property's maxLength was unset from `1024` for the response status `201`
  - the `data/city` response's property type changed from `string, null` to no type for status `201`
  - the `data/created_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `201`
  - the `data/customer_id` response's property type changed from `string` to no type for status `201`
  - the `data/description` response's property type changed from `string, null` to no type for status `201`
  - the `data/first_line` response's property type changed from `string, null` to no type for status `201`
  - the `data/id` response's property type changed from `string` to no type for status `201`
  - the `data/postal_code` response's property type changed from `string, null` to no type for status `201`
  - the `data/region` response's property type changed from `string, null` to no type for status `201`
  - the `data/second_line` response's property type changed from `string, null` to no type for status `201`
  - the `data/status` response's property type changed from `string` to no type for status `201`
  - the `data/updated_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `201`
  - the `error` response's property type changed from `object` to no type for status `default`
  - removed the required property `error/code` from the response with the `default` status
  - removed the required property `error/detail` from the response with the `default` status
  - removed the required property `error/documentation_url` from the response with the `default` status
  - removed the required property `error/type` from the response with the `default` status
  - removed the optional property `error/errors` from the response with the `default` status
  - the request optional property `import_meta` became not read-only
  - added `#/components/schemas/CustomData, subschema #2` to the `custom_data` request property `anyOf` list
  - added `#/components/schemas/ImportMeta, subschema #2` to the `import_meta` request property `anyOf` list
  - request property `city` list-of-types was widened by adding types `null` to media type `application/json`
  - …45 more
- **2025-03-07** (v1) `a3359d7731fd`: 7 breaking, 5 info
  - the request property `import_meta/oneOf[subschema #1: ImportMeta]/external_id` became not nullable
  - the `import_meta/oneOf[subschema #1: ImportMeta]/external_id` request property type changed from `string, null` to no type
  - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `201`
  - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `201`
  - added `#/components/schemas/external_id, subschema #2` to the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/migration_provider_public` to the `data/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `201`
  - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `201`
  - the `import_meta/oneOf[subschema #1: ImportMeta]/external_id` request property's minLength was decreased from `1` to `0`
  - added `#/components/schemas/external_id, subschema #2` to the `import_meta/oneOf[subschema #1: ImportMeta]/external_id` request property `oneOf` list
  - added `#/components/schemas/migration_provider_public` to the `import_meta/oneOf[subschema #1: ImportMeta]/imported_from` request property `oneOf` list
  - the request required property `import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only
  - the response required property `data/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `201`
- **2024-12-06** (v1) `274e5b2be190`: 232 breaking, 230 info
  - removed the enum value `AD` of the request property `country_code`
  - removed the enum value `AE` of the request property `country_code`
  - removed the enum value `AG` of the request property `country_code`
  - removed the enum value `AI` of the request property `country_code`
  - removed the enum value `AL` of the request property `country_code`
  - removed the enum value `AM` of the request property `country_code`
  - removed the enum value `AO` of the request property `country_code`
  - removed the enum value `AR` of the request property `country_code`
  - removed the enum value `AS` of the request property `country_code`
  - removed the enum value `AT` of the request property `country_code`
  - removed the enum value `AU` of the request property `country_code`
  - removed the enum value `AW` of the request property `country_code`
  - removed the enum value `AX` of the request property `country_code`
  - removed the enum value `AZ` of the request property `country_code`
  - removed the enum value `BA` of the request property `country_code`
  - removed the enum value `BB` of the request property `country_code`
  - removed the enum value `BD` of the request property `country_code`
  - removed the enum value `BE` of the request property `country_code`
  - removed the enum value `BF` of the request property `country_code`
  - removed the enum value `BG` of the request property `country_code`
  - removed the enum value `BH` of the request property `country_code`
  - removed the enum value `BI` of the request property `country_code`
  - removed the enum value `BJ` of the request property `country_code`
  - removed the enum value `BL` of the request property `country_code`
  - removed the enum value `BM` of the request property `country_code`
  - removed the enum value `BN` of the request property `country_code`
  - removed the enum value `BO` of the request property `country_code`
  - removed the enum value `BQ` of the request property `country_code`
  - removed the enum value `BR` of the request property `country_code`
  - removed the enum value `BS` of the request property `country_code`
  - removed the enum value `BT` of the request property `country_code`
  - removed the enum value `BV` of the request property `country_code`
  - removed the enum value `BW` of the request property `country_code`
  - removed the enum value `BZ` of the request property `country_code`
  - removed the enum value `CA` of the request property `country_code`
  - removed the enum value `CC` of the request property `country_code`
  - removed the enum value `CG` of the request property `country_code`
  - removed the enum value `CH` of the request property `country_code`
  - removed the enum value `CI` of the request property `country_code`
  - removed the enum value `CK` of the request property `country_code`
  - …422 more
- **2024-05-14** (v1) `61fe84bfd516`: 1 info
  - added the optional property `data/customer_id` to the response with the `201` status
- **2024-02-19** (v1) `a4a4068ff792`: 7 breaking, 1 warning, 6 info
  - the request property `custom_data` became not nullable
  - the `custom_data` request property type changed from `object, null` to no type
  - added `#/components/schemas/custom_data, subschema #2` to the `data/custom_data` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/import_meta, subschema #2` to the `data/import_meta` response property `oneOf` list for the response status `201`
  - the `data/custom_data` response's property type changed from `object, null` to no type for status `201`
  - the `data/import_meta` response's property type changed from `object, null` to no type for status `201`
  - removed the required property `data/import_meta/imported_from` from the response with the `201` status
  - removed the optional property `data/import_meta/external_id` from the response with the `201` status
  - added `#/components/schemas/custom_data, subschema #2` to the `custom_data` request property `oneOf` list
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `500`

---

[Operation](https://skmtc.dev/paddlehq/apis/paddle-api/docs/customers/:customer_id/addresses/post.md) - [API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [Page](https://skmtc.dev/paddlehq/apis/paddle-api/changes/customers/:customer_id/addresses/post)
