> For the complete Lynkow documentation index in agent-friendly format, see [llms.txt](/llms.txt).

# Update the current customer's address

**Publié le** : 2026-08-19
**Catégorie** : Commerce

## `PATCH /customers/me/addresses/:id`

**Update the current customer's address**

Partially updates one live address owned by the authenticated
buyer. Both `X-Lynkow-Pk` and `Authorization: Bearer <customer-session-token>` are required. `{id}` must be an `addr_`
identifier, and the body must contain at least one address field.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | Yes | Unique identifier |


### Request Body

Content-Type: `application/json`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `addressName` | string \| null | No |  |
| `firstName` | string | No | 1-120 characters |
| `lastName` | string | No | 1-120 characters |
| `company` | string \| null | No |  |
| `address1` | string | No | 1-255 characters |
| `address2` | string \| null | No |  |
| `city` | string | No | 1-120 characters |
| `postalCode` | string | No | 1-32 characters |
| `province` | string \| null | No |  |
| `countryCode` | string | No | ISO 3166-1 alpha-2 country code |
| `phone` | string \| null | No |  |
| `isDefaultShipping` | boolean | No | Whether this is the customer's default shipping address. Boolean |
| `isDefaultBilling` | boolean | No | Whether this is the customer's default billing address. Boolean |
| `metadata` | object | No | Custom key-value metadata |


### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Missing or invalid storefront publishable key |
| `402` | The site subscription does not currently permit this operation |
| `403` | The storefront key origin is not allowed |
| `404` | Not found |
| `422` | Validation error |


> **Notes:** Missing or invalid customer authentication returns 401. A foreign,
> cross-site, soft-deleted, or absent address returns the same 404.
> Validation failures return 422. Concurrent promotion of a default
> address may return 409. Storefront spam controls apply to this write.

### Examples

```curl
curl -X PATCH "https://api.lynkow.com/storefront/{siteId}/customers/me/addresses/addr_..." \
  -H "X-Lynkow-Pk: lkw_pk_..." \
  -H "Authorization: Bearer <customer-session-token>" \
  -H "Content-Type: application/json" \
  -d "{ \"city\": \"Barcelona\", \"_hp\": \"\", \"_ts\": $(( $(date +%s) * 1000 - 5000 )) }"
```

---