---
title: "Creates a new customer address"
method: POST
path: "/api/v1/customer-addresses"
tags: ["CustomerAddresses"]
---

# Creates a new customer address

`POST /api/v1/customer-addresses`

## Request body

- BillbeeInterfacesBillbeeAPIModelCustomerAddressApiModel — Container for passing address data
  - `Id` integer — The internal Billbee ID of the address record. Can be null if a new address is created
  - `AddressType` 1 | 2 — The type of the address
  - `CustomerId` integer — The internal Billbee id of the customer the address belongs to
  - `Company` string — The name of the company
  - `FirstName` string
  - `LastName` string
  - `Name2` string — Optionally an additional name field
  - `Street` string
  - `Housenumber` string
  - `Zip` string
  - `City` string
  - `State` string
  - `CountryCode` string — The ISO2 code of the country
  - `Email` string
  - `Tel1` string
  - `Tel2` string
  - `Fax` string
  - `AddressAddition` string
  - `ArchivedAt` string, date-time — If set, the customeraddress was already archived at the given date. Further modification is disabled.
  - `RestoredAt` string, date-time — If set, the customeraddress was restored from the archive at the given date.

## Response `200`

OK

- RechnungsdruckWebAppControllersApiApiResultOfBillbeeInterfacesBillbeeAPIModelCustomerAddressApiModel
  - `ErrorMessage` string
  - `ErrorCode` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31
  - `ErrorDescription` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31
  - `Data` BillbeeInterfacesBillbeeAPIModelCustomerAddressApiModel — Container for passing address data
    - `Id` integer — The internal Billbee ID of the address record. Can be null if a new address is created
    - `AddressType` 1 | 2 — The type of the address
    - `CustomerId` integer — The internal Billbee id of the customer the address belongs to
    - `Company` string — The name of the company
    - `FirstName` string
    - `LastName` string
    - `Name2` string — Optionally an additional name field
    - `Street` string
    - `Housenumber` string
    - `Zip` string
    - `City` string
    - `State` string
    - `CountryCode` string — The ISO2 code of the country
    - `Email` string
    - `Tel1` string
    - `Tel2` string
    - `Fax` string
    - `AddressAddition` string
    - `ArchivedAt` string, date-time — If set, the customeraddress was already archived at the given date. Further modification is disabled.
    - `RestoredAt` string, date-time — If set, the customeraddress was restored from the archive at the given date.

---

[API](https://skmtc.dev/billbee/apis/billbee-api.md) · [All operations](https://skmtc.dev/billbee/apis/billbee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/billbee/billbee-api/revisions/e64f07f4f526/schema)