---
title: "Update address"
method: PATCH
path: "/api/v2/customers/{customerId}/addresses/{id}"
tags: ["Customer Address"]
---

# Update address

`PATCH /api/v2/customers/{customerId}/addresses/{id}`

Updates given fields for a given customer address

## Path parameters

- `customerId` string, required — Resource identifier.
- `id` union, required
  - 'masterdata' | 'billingaddress'
  - string — Resource identifier.

## Request body

- union
  - object
    - `street` string — Street name + Housenumber of the address
    - `addressSupplement` string, nullable — Additional supplement for address
    - `zip` string — ZIP code of address
    - `city` string — Name of city
    - `country` string — ISO code (ISO 3166-1 alpha-2) of country
    - `state` string, nullable — ISO code (ISO 3166-2 without country part) of state/province
    - `department` string, nullable — Name of deptartment
    - `subDepartment` string, nullable — Name of sub-department
  - object
    - `name` string — Full name for billing address
    - `salutation` 'mr' | 'mrs' | 'company' | 'other', nullable — Abbreviation for salutation
    - `street` string — Street name + Housenumber of the address
    - `addressSupplement` string, nullable — Additional supplement for address
    - `zip` string — ZIP code of address
    - `city` string — Name of city
    - `country` string — ISO code (ISO 3166-1 alpha-2) of country
    - `state` string, nullable — ISO code (ISO 3166-2 without country part) of state/province
    - `department` string, nullable — Name of deptartment
    - `subDepartment` string, nullable — Name of sub-department
    - `contactDetails` object
      - `phone` string, nullable — Phone number
      - `email` string, nullable — Email address
      - `gln` string, number, nullable — Global Location Number - key to identify physical/digital location globally
  - object
    - `name` string, nullable — Full name for billing address
    - `salutation` 'mr' | 'mrs' | 'company' | 'other', nullable — Abbreviation for salutation
    - `street` string — Street name + Housenumber of the address
    - `addressSupplement` string, nullable — Additional supplement for address
    - `zip` string — ZIP code of address
    - `city` string — Name of city
    - `country` string — ISO code (ISO 3166-1 alpha-2) of country
    - `state` string, nullable — ISO code (ISO 3166-2 without country part) of state/province
    - `department` string, nullable — Name of deptartment
    - `subDepartment` string, nullable — Name of sub-department
    - `contactDetails` object, nullable
      - `phone` string, nullable — Phone number
      - `email` string, nullable — Email address
      - `gln` string, number, nullable — Global Location Number - key to identify physical/digital location globally
    - `deliveryDetails` object, nullable
      - `defaultDeliveryAddress` boolean — Set TRUE makes this address to default delivery address
      - `termsOfDelivery` string, nullable — Terms of delivery
      - `vatId` string, nullable — VAT Id if different from masterdata
      - `taxType` 'domestic' | 'eu-delivery' | 'export' | 'free' — Taxation type
      - `internalComment` string, nullable — Internal Comments
      - `note` string, nullable — General Notes

## Response `204`

Operation completed successfully, no response body

## Other responses

- `400` — IETF RFC 9457 Problem API compliant response
- `401` — Unable to authenticate the client
- `403` — Unable to authorize the client
- `404` — Resource was not found or not enough access privileges
- `406` — Requested resource representation does not exist.

---

[API](https://skmtc.net/xentral/apis/xentral-api.md) · [All operations](https://skmtc.net/xentral/apis/xentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xentral/xentral-api/revisions/8a27ba392442/schema)