PUT
/
customers
/
{customer_id}
/
addresses
/
{address_id}
Update Address
curl --request PUT \
  --url https://api.wizcommerce.com/v1/customers/{customer_id}/addresses/{address_id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "reference_id": "ADDR123",
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+14155552671",
  "email": "john.doe@example.com",
  "address_line_1": "123 Main St",
  "address_line_2": "Apt 101",
  "city": "Anytown",
  "state": "CA",
  "country": "US",
  "zip_code": "12345",
  "type": "billing",
  "is_default": true,
  "attributes": [
    {
      "name": "1234567890",
      "value": "red"
    }
  ]
}'
{
  "data": {
    "id": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
    "customer_id": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
    "reference_id": "ADDR123",
    "address_line_1": "123 Main St",
    "address_line_2": "Apt 101",
    "city": "Anytown",
    "state": "CA",
    "country": "USA",
    "zip_code": "12345",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+14155552671",
    "email": "john.doe@example.com",
    "type": "billing",
    "status": "active",
    "is_default": false,
    "attributes": [
      {
        "id": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
        "name": "Color",
        "value": "Red",
        "created_by": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
        "updated_by": "01f5d171-d3e3-4b2b-bd57-0727194b5bed",
        "created_at": "2021-01-01T00:00:00Z",
        "updated_at": "2021-01-01T00:00:00Z"
      }
    ],
    "created_at": "2025-01-01T15:04:05Z",
    "updated_at": "2025-01-01T15:04:05Z"
  }
}
The PUT request is used to fully replace an existing entity with a new one based on the provided ID. This means:
  • All fields in the request body will overwrite the existing entity.
  • Any missing fields will be removed from the entity.
  • The request is idempotent, meaning multiple identical PUT requests will always result in the same final state.

Authorizations

​
X-API-Key
string
header
required

API Key for authentication

Path Parameters

​
customer_id
string
required

customer_id

​
address_id
string
required

address_id

Body

application/json

request

The body is of type object.

Response

201
application/json

Created

The response is of type object.