> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# PATCH /customers/{customer_id}/addresses/{address_id}

**Update an address for a customer**

Updates an address for a customer using its ID and related customer ID.

If successful, your response includes a copy of the updated address entity.

**Required permissions:** `address.write`

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `address_id` | string | required | Paddle ID of the address entity to work with. |
| `customer_id` | string | required | Unique Paddle ID for this customer entity, prefixed with `ctm_`. (pattern: `^ctm_[a-z\d]{26}$`) |

## Request body

- `description`: string | null — Memorable description for this address. (Max length: 1024)
- `first_line`: string | null — First line of this address. (Max length: 1024)
- `second_line`: string | null — Second line of this address. (Max length: 1024)
- `city`: string | null — City of this address. (Max length: 200)
- `postal_code`: string | null — ZIP or postal code of this address. Required for some countries. (Max length: 200)
- `region`: string | null — State, county, or region of this address. (Max length: 200)
- `country_code` — Supported two-letter ISO 3166-1 alpha-2 country code for this address.
  - string — Two-letter code for a country that Paddle supports sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign.
    - `AD` — Andorra
    - `AE` — United Arab Emirates
    - `AG` — Antigua and Barbuda
    - `AI` — Anguilla
    - `AL` — Albania
    - `AM` — Armenia
    - `AO` — Angola
    - `AR` — Argentina
    - `AS` — American Samoa
    - `AT` — Austria
    - `AU` — Australia
    - `AW` — Aruba
    - `AX` — Åland Islands
    - `AZ` — Azerbaijan
    - `BA` — Bosnia and Herzegovina
    - `BB` — Barbados
    - `BD` — Bangladesh
    - `BE` — Belgium
    - `BF` — Burkina Faso
    - `BG` — Bulgaria
    - `BH` — Bahrain
    - `BI` — Burundi
    - `BJ` — Benin
    - `BL` — Saint Barthélemy
    - `BM` — Bermuda
    - `BN` — Brunei
    - `BO` — Bolivia
    - `BQ` — Caribbean Netherlands (Bonaire, Sint Eustatius, and Saba)
    - `BR` — Brazil
    - `BS` — Bahamas
    - `BT` — Bhutan
    - `BV` — Bouvet Island
    - `BW` — Botswana
    - `BZ` — Belize
    - `CA` — Canada
    - `CC` — Cocos Islands
    - `CG` — Republic of Congo
    - `CH` — Switzerland
    - `CI` — Côte d'Ivoire (Ivory Coast)
    - `CK` — Cook Islands
    - `CL` — Chile
    - `CM` — Cameroon
    - `CN` — China
    - `CO` — Colombia
    - `CR` — Costa Rica
    - `CV` — Cape Verde
    - `CW` — Curaçao
    - `CX` — Christmas Island
    - `CY` — Cyprus
    - `CZ` — Czechia (Czech Republic)
    - `DE` — Germany
    - `DJ` — Djibouti
    - `DK` — Denmark
    - `DM` — Dominica
    - `DO` — Dominican Republic
    - `DZ` — Algeria
    - `EC` — Ecuador
    - `EE` — Estonia
    - `EG` — Egypt
    - `EH` — Western Sahara
    - `ER` — Eritrea
    - `ES` — Spain
    - `ET` — Ethiopia
    - `FI` — Finland
    - `FJ` — Fiji
    - `FK` — Falkland Islands
    - `FM` — Micronesia
    - `FO` — Faroe Islands
    - `FR` — France
    - `GA` — Gabon
    - `GB` — United Kingdom
    - `GD` — Grenada
    - `GE` — Georgia
    - `GF` — French Guiana
    - `GG` — Guernsey
    - `GH` — Ghana
    - `GI` — Gibraltar
    - `GL` — Greenland
    - `GM` — Gambia
    - `GN` — Guinea
    - `GP` — Guadeloupe
    - `GQ` — Equatorial Guinea
    - `GR` — Greece
    - `GS` — South Georgia and the South Sandwich Islands
    - `GT` — Guatemala
    - `GU` — Guam
    - `GW` — Guinea-Bissau
    - `GY` — Guyana
    - `HK` — Hong Kong
    - `HM` — Heard Island and McDonald Islands
    - `HN` — Honduras
    - `HR` — Croatia
    - `HU` — Hungary
    - `ID` — Indonesia
    - `IE` — Ireland
    - `IL` — Israel
    - `IM` — Isle of Man
    - `IN` — India
    - `IO` — British Indian Ocean Territory
    - `IQ` — Iraq
    - `IS` — Iceland
    - `IT` — Italy
    - `JE` — Jersey
    - `JM` — Jamaica
    - `JO` — Jordan
    - `JP` — Japan
    - `KE` — Kenya
    - `KG` — Kyrgyzstan
    - `KH` — Cambodia
    - `KI` — Kiribati
    - `KM` — Comoros
    - `KN` — Saint Kitts and Nevis
    - `KR` — South Korea
    - `KW` — Kuwait
    - `KY` — Cayman Islands
    - `KZ` — Kazakhstan
    - `LA` — Lao People's Democratic Republic (Laos)
    - `LB` — Lebanon
    - `LC` — Saint Lucia
    - `LI` — Liechtenstein
    - `LK` — Sri Lanka
    - `LR` — Liberia
    - `LS` — Lesotho
    - `LT` — Lithuania
    - `LU` — Luxembourg
    - `LV` — Latvia
    - `MA` — Morocco
    - `MC` — Monaco
    - `MD` — Moldova
    - `ME` — Montenegro
    - `MF` — Saint Martin
    - `MG` — Madagascar
    - `MH` — Marshall Islands
    - `MK` — Macedonia
    - `MN` — Mongolia
    - `MO` — Macao
    - `MP` — Northern Mariana Islands
    - `MQ` — Martinique
    - `MR` — Mauritania
    - `MS` — Montserrat
    - `MT` — Malta
    - `MU` — Mauritius
    - `MV` — Maldives
    - `MW` — Malawi
    - `MX` — Mexico
    - `MY` — Malaysia
    - `MZ` — Mozambique
    - `NA` — Namibia
    - `NC` — New Caledonia
    - `NE` — Niger
    - `NF` — Norfolk Island
    - `NG` — Nigeria
    - `NL` — Netherlands
    - `NO` — Norway
    - `NP` — Nepal
    - `NR` — Nauru
    - `NU` — Niue
    - `NZ` — New Zealand
    - `OM` — Oman
    - `PA` — Panama
    - `PE` — Peru
    - `PF` — French Polynesia
    - `PG` — Papua New Guinea
    - `PH` — Philippines
    - `PK` — Pakistan
    - `PL` — Poland
    - `PM` — Saint Pierre and Miquelon
    - `PN` — Pitcairn
    - `PR` — Puerto Rico
    - `PS` — Palestinian territories
    - `PT` — Portugal
    - `PW` — Palau
    - `PY` — Paraguay
    - `QA` — Qatar
    - `RE` — Reunion
    - `RO` — Romania
    - `RS` — Republic of Serbia
    - `RW` — Rwanda
    - `SA` — Saudi Arabia
    - `SB` — Solomon Islands
    - `SC` — Seychelles
    - `SE` — Sweden
    - `SG` — Singapore
    - `SH` — Saint Helena
    - `SI` — Slovenia
    - `SJ` — Svalbard and Jan Mayen
    - `SK` — Slovakia
    - `SL` — Sierra Leone
    - `SM` — San Marino
    - `SN` — Senegal
    - `SR` — Suriname
    - `ST` — São Tomé and Príncipe
    - `SV` — El Salvador
    - `SX` — Sint Maarten
    - `SZ` — Swaziland
    - `TC` — Turks and Caicos Islands
    - `TD` — Chad
    - `TF` — French Southern and Antarctic Lands
    - `TG` — Togo
    - `TH` — Thailand
    - `TJ` — Tajikistan
    - `TK` — Tokelau
    - `TL` — Timor-Leste
    - `TM` — Turkmenistan
    - `TN` — Tunisia
    - `TO` — Tonga
    - `TR` — Turkey
    - `TT` — Trinidad and Tobago
    - `TV` — Tuvalu
    - `TW` — Taiwan
    - `TZ` — Tanzania
    - `UA` — Ukraine
    - `UG` — Uganda
    - `UM` — United States Minor Outlying Islands
    - `US` — United States
    - `UY` — Uruguay
    - `UZ` — Uzbekistan
    - `VA` — Holy See (Vatican City)
    - `VC` — Saint Vincent and the Grenadines
    - `VG` — British Virgin Islands
    - `VI` — U.S. Virgin Islands
    - `VN` — Vietnam
    - `VU` — Vanuatu
    - `WF` — Wallis and Futuna
    - `WS` — Samoa
    - `XK` — Kosovo
    - `YT` — Mayotte
    - `ZA` — South Africa
    - `ZM` — Zambia
  - string — Two-letter code for a country that Paddle does not support sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign.
    - `AF` — Afghanistan
    - `AQ` — Antarctica
    - `AN` — Netherlands Antilles. Withdrawn ISO 3166-1 code, succeeded by BQ, CW and SX.
    - `BY` — Belarus
    - `CD` — Democratic Republic of Congo
    - `CF` — Central African Republic
    - `CU` — Cuba
    - `CS` — Serbia and Montenegro. Withdrawn ISO 3166-1 code, succeeded by RS and ME.
    - `HT` — Haiti
    - `IR` — Iran
    - `KP` — North Korea
    - `LY` — Libya
    - `ML` — Mali
    - `MM` — Myanmar (Burma)
    - `NI` — Nicaragua
    - `RU` — Russia
    - `SO` — Somalia
    - `SS` — South Sudan
    - `SD` — Sudan
    - `SY` — Syria
    - `VE` — Venezuela
    - `YE` — Yemen
    - `ZW` — Zimbabwe
- `custom_data`: object | null — Your own structured key-value data.
- `status`: string — Whether this entity can be used in Paddle.
  - `active` — Entity is active and can be used.
  - `archived` — Entity is archived, so can't be used.

### Request example

```json
{
  "description": "California Office",
  "first_line": "5400 E Washington Drive, Floor 2",
  "city": "San Jose",
  "region": "CA",
  "custom_data": {
    "crm_id": "08bcfb7a-41d8-4747-9ade-3d885c287d0f"
  }
}
```

## Response (200)

- `data`: object (required) — Represents an address entity.
  - `id`: string (required) — Unique Paddle ID for this address entity, prefixed with `add_`. (pattern: `^add_[a-z\d]{26}$`)
  - `customer_id`: string (required) — Paddle ID for the customer related to this address, prefixed with `ctm_`. (pattern: `^ctm_[a-z\d]{26}$`)
  - `description`: string | null (required) — Memorable description for this address. (Max length: 1024)
  - `first_line`: string | null (required) — First line of this address. (Max length: 1024)
  - `second_line`: string | null (required) — Second line of this address. (Max length: 1024)
  - `city`: string | null (required) — City of this address. (Max length: 200)
  - `postal_code`: string | null (required) — ZIP or postal code of this address. Required for some countries. (Max length: 200)
  - `region`: string | null (required) — State, county, or region of this address. (Max length: 200)
  - `country_code` (required) — Supported two-letter ISO 3166-1 alpha-2 country code for this address.
    - string — Two-letter code for a country that Paddle supports sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign.
      - `AD` — Andorra
      - `AE` — United Arab Emirates
      - `AG` — Antigua and Barbuda
      - `AI` — Anguilla
      - `AL` — Albania
      - `AM` — Armenia
      - `AO` — Angola
      - `AR` — Argentina
      - `AS` — American Samoa
      - `AT` — Austria
      - `AU` — Australia
      - `AW` — Aruba
      - `AX` — Åland Islands
      - `AZ` — Azerbaijan
      - `BA` — Bosnia and Herzegovina
      - `BB` — Barbados
      - `BD` — Bangladesh
      - `BE` — Belgium
      - `BF` — Burkina Faso
      - `BG` — Bulgaria
      - `BH` — Bahrain
      - `BI` — Burundi
      - `BJ` — Benin
      - `BL` — Saint Barthélemy
      - `BM` — Bermuda
      - `BN` — Brunei
      - `BO` — Bolivia
      - `BQ` — Caribbean Netherlands (Bonaire, Sint Eustatius, and Saba)
      - `BR` — Brazil
      - `BS` — Bahamas
      - `BT` — Bhutan
      - `BV` — Bouvet Island
      - `BW` — Botswana
      - `BZ` — Belize
      - `CA` — Canada
      - `CC` — Cocos Islands
      - `CG` — Republic of Congo
      - `CH` — Switzerland
      - `CI` — Côte d'Ivoire (Ivory Coast)
      - `CK` — Cook Islands
      - `CL` — Chile
      - `CM` — Cameroon
      - `CN` — China
      - `CO` — Colombia
      - `CR` — Costa Rica
      - `CV` — Cape Verde
      - `CW` — Curaçao
      - `CX` — Christmas Island
      - `CY` — Cyprus
      - `CZ` — Czechia (Czech Republic)
      - `DE` — Germany
      - `DJ` — Djibouti
      - `DK` — Denmark
      - `DM` — Dominica
      - `DO` — Dominican Republic
      - `DZ` — Algeria
      - `EC` — Ecuador
      - `EE` — Estonia
      - `EG` — Egypt
      - `EH` — Western Sahara
      - `ER` — Eritrea
      - `ES` — Spain
      - `ET` — Ethiopia
      - `FI` — Finland
      - `FJ` — Fiji
      - `FK` — Falkland Islands
      - `FM` — Micronesia
      - `FO` — Faroe Islands
      - `FR` — France
      - `GA` — Gabon
      - `GB` — United Kingdom
      - `GD` — Grenada
      - `GE` — Georgia
      - `GF` — French Guiana
      - `GG` — Guernsey
      - `GH` — Ghana
      - `GI` — Gibraltar
      - `GL` — Greenland
      - `GM` — Gambia
      - `GN` — Guinea
      - `GP` — Guadeloupe
      - `GQ` — Equatorial Guinea
      - `GR` — Greece
      - `GS` — South Georgia and the South Sandwich Islands
      - `GT` — Guatemala
      - `GU` — Guam
      - `GW` — Guinea-Bissau
      - `GY` — Guyana
      - `HK` — Hong Kong
      - `HM` — Heard Island and McDonald Islands
      - `HN` — Honduras
      - `HR` — Croatia
      - `HU` — Hungary
      - `ID` — Indonesia
      - `IE` — Ireland
      - `IL` — Israel
      - `IM` — Isle of Man
      - `IN` — India
      - `IO` — British Indian Ocean Territory
      - `IQ` — Iraq
      - `IS` — Iceland
      - `IT` — Italy
      - `JE` — Jersey
      - `JM` — Jamaica
      - `JO` — Jordan
      - `JP` — Japan
      - `KE` — Kenya
      - `KG` — Kyrgyzstan
      - `KH` — Cambodia
      - `KI` — Kiribati
      - `KM` — Comoros
      - `KN` — Saint Kitts and Nevis
      - `KR` — South Korea
      - `KW` — Kuwait
      - `KY` — Cayman Islands
      - `KZ` — Kazakhstan
      - `LA` — Lao People's Democratic Republic (Laos)
      - `LB` — Lebanon
      - `LC` — Saint Lucia
      - `LI` — Liechtenstein
      - `LK` — Sri Lanka
      - `LR` — Liberia
      - `LS` — Lesotho
      - `LT` — Lithuania
      - `LU` — Luxembourg
      - `LV` — Latvia
      - `MA` — Morocco
      - `MC` — Monaco
      - `MD` — Moldova
      - `ME` — Montenegro
      - `MF` — Saint Martin
      - `MG` — Madagascar
      - `MH` — Marshall Islands
      - `MK` — Macedonia
      - `MN` — Mongolia
      - `MO` — Macao
      - `MP` — Northern Mariana Islands
      - `MQ` — Martinique
      - `MR` — Mauritania
      - `MS` — Montserrat
      - `MT` — Malta
      - `MU` — Mauritius
      - `MV` — Maldives
      - `MW` — Malawi
      - `MX` — Mexico
      - `MY` — Malaysia
      - `MZ` — Mozambique
      - `NA` — Namibia
      - `NC` — New Caledonia
      - `NE` — Niger
      - `NF` — Norfolk Island
      - `NG` — Nigeria
      - `NL` — Netherlands
      - `NO` — Norway
      - `NP` — Nepal
      - `NR` — Nauru
      - `NU` — Niue
      - `NZ` — New Zealand
      - `OM` — Oman
      - `PA` — Panama
      - `PE` — Peru
      - `PF` — French Polynesia
      - `PG` — Papua New Guinea
      - `PH` — Philippines
      - `PK` — Pakistan
      - `PL` — Poland
      - `PM` — Saint Pierre and Miquelon
      - `PN` — Pitcairn
      - `PR` — Puerto Rico
      - `PS` — Palestinian territories
      - `PT` — Portugal
      - `PW` — Palau
      - `PY` — Paraguay
      - `QA` — Qatar
      - `RE` — Reunion
      - `RO` — Romania
      - `RS` — Republic of Serbia
      - `RW` — Rwanda
      - `SA` — Saudi Arabia
      - `SB` — Solomon Islands
      - `SC` — Seychelles
      - `SE` — Sweden
      - `SG` — Singapore
      - `SH` — Saint Helena
      - `SI` — Slovenia
      - `SJ` — Svalbard and Jan Mayen
      - `SK` — Slovakia
      - `SL` — Sierra Leone
      - `SM` — San Marino
      - `SN` — Senegal
      - `SR` — Suriname
      - `ST` — São Tomé and Príncipe
      - `SV` — El Salvador
      - `SX` — Sint Maarten
      - `SZ` — Swaziland
      - `TC` — Turks and Caicos Islands
      - `TD` — Chad
      - `TF` — French Southern and Antarctic Lands
      - `TG` — Togo
      - `TH` — Thailand
      - `TJ` — Tajikistan
      - `TK` — Tokelau
      - `TL` — Timor-Leste
      - `TM` — Turkmenistan
      - `TN` — Tunisia
      - `TO` — Tonga
      - `TR` — Turkey
      - `TT` — Trinidad and Tobago
      - `TV` — Tuvalu
      - `TW` — Taiwan
      - `TZ` — Tanzania
      - `UA` — Ukraine
      - `UG` — Uganda
      - `UM` — United States Minor Outlying Islands
      - `US` — United States
      - `UY` — Uruguay
      - `UZ` — Uzbekistan
      - `VA` — Holy See (Vatican City)
      - `VC` — Saint Vincent and the Grenadines
      - `VG` — British Virgin Islands
      - `VI` — U.S. Virgin Islands
      - `VN` — Vietnam
      - `VU` — Vanuatu
      - `WF` — Wallis and Futuna
      - `WS` — Samoa
      - `XK` — Kosovo
      - `YT` — Mayotte
      - `ZA` — South Africa
      - `ZM` — Zambia
    - string — Two-letter code for a country that Paddle does not support sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign.
      - `AF` — Afghanistan
      - `AQ` — Antarctica
      - `AN` — Netherlands Antilles. Withdrawn ISO 3166-1 code, succeeded by BQ, CW and SX.
      - `BY` — Belarus
      - `CD` — Democratic Republic of Congo
      - `CF` — Central African Republic
      - `CU` — Cuba
      - `CS` — Serbia and Montenegro. Withdrawn ISO 3166-1 code, succeeded by RS and ME.
      - `HT` — Haiti
      - `IR` — Iran
      - `KP` — North Korea
      - `LY` — Libya
      - `ML` — Mali
      - `MM` — Myanmar (Burma)
      - `NI` — Nicaragua
      - `RU` — Russia
      - `SO` — Somalia
      - `SS` — South Sudan
      - `SD` — Sudan
      - `SY` — Syria
      - `VE` — Venezuela
      - `YE` — Yemen
      - `ZW` — Zimbabwe
  - `custom_data`: object | null (required) — Your own structured key-value data.
  - `status`: string (required) — Whether this entity can be used in Paddle. (default: `"active"`)
    - `active` — Entity is active and can be used.
    - `archived` — Entity is archived, so can't be used.
  - `created_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
  - `updated_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
  - `import_meta`: object | null (required) — Import information for this entity. `null` if this entity is not imported.
    - `external_id`: string | null — Reference or identifier for this entity from the provider where it was imported from. (Length: 1–200)
    - `imported_from`: string (required) — Name of the platform or provider where this entity was imported from. (Length: 1–200)
- `meta`: object (required) — Information about this response.
  - `request_id`: string (required) — Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.

### Response example

```json
{
  "data": {
    "id": "add_01hv8gwdfkw5z6d1yy6pa3xyrz",
    "status": "active",
    "customer_id": "ctm_01hv6y1jedq4p1n0yqn5ba3ky4",
    "description": "California Office",
    "first_line": "5400 E Washington Drive, Floor 2",
    "second_line": null,
    "city": "San Jose",
    "postal_code": "95314",
    "region": "CA",
    "country_code": "US",
    "custom_data": {
      "crm_id": "08bcfb7a-41d8-4747-9ade-3d885c287d0f"
    },
    "created_at": "2024-04-12T06:45:53.267Z",
    "updated_at": "2024-04-12T06:47:01.533006Z",
    "import_meta": null
  },
  "meta": {
    "request_id": "c3308aa6-fdba-457d-af96-6a51e7292b90"
  }
}
```