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

# Create address

`POST /api/v2/customers/{customerId}/addresses`

Create new customer address

## Path parameters

- `customerId` string, required — Resource identifier.

## Request body

- union
  - object
    - `type` 'masterdata', required — Type of customer address, must be 'masterdata'
    - `street` string, required — Street name + Housenumber of the address
    - `addressSupplement` string, nullable — Additional supplement for address
    - `zip` string, nullable — ZIP code of address
    - `city` string, required — Name of city
    - `country` string, required — ISO code (ISO 3166-1 alpha-2) of country
    - `state` string, nullable — ISO code (ISO 3166-2 without country part) of state/province
  - object
    - `type` 'billingaddress', required — Type of customer address, must be 'billingaddress'
    - `name` string, required — Full name for billing address
    - `salutation` 'mr' | 'mrs' | 'company' | 'other', nullable — Abbreviation for salutation
    - `street` string, required — Street name + House number of the address
    - `addressSupplement` string, nullable — Additional supplement for address
    - `zip` string, nullable — ZIP code of address
    - `city` string, required — Name of city
    - `country` string, required — 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 department
    - `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
  - object
    - `type` 'deliveryaddress', required — Type of customer address, must be 'deliveryaddress'
    - `name` string, required — Full name for billing address
    - `salutation` 'mr' | 'mrs' | 'company' | 'other', nullable — Abbreviation for salutation
    - `street` string, required — Street name + House number of the address
    - `addressSupplement` string, nullable — Additional supplement for address
    - `zip` string, nullable — ZIP code of address
    - `city` string, required — Name of city
    - `country` string, required — 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 department
    - `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
    - `deliveryDetails` object, nullable
      - `defaultDeliveryAddress` boolean — Set TRUE makes this address to default delivery address
      - `termsOfDelivery` string, nullable — Terms of delivery associated with this address
      - `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 `201`

Resource successfully created response

## 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
- `409` — Request conflict with the current state of the target resource
- `415` — Resource representation send in the request is not supported.
- `429` — Too many API calls made.

---

[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)