---
title: "Updates a customer by id"
method: PUT
path: "/api/v1/customers/{id}"
tags: ["Customers"]
---

# Updates a customer by id

`PUT /api/v1/customers/{id}`

## Path parameters

- `id` integer, required

## Request body

- BillbeeInterfacesBillbeeAPIModelCustomerApiModel
  - `Id` integer — The Billbee Id of the customer
  - `Name` string
  - `Email` string
  - `Tel1` string
  - `Tel2` string
  - `Number` integer
  - `PriceGroupId` integer
  - `LanguageId` integer
  - `DefaultMailAddress` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
    - `Id` integer
    - `TypeId` integer
    - `TypeName` string
    - `SubType` string
    - `Value` string
  - `DefaultCommercialMailAddress` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
    - `Id` integer
    - `TypeId` integer
    - `TypeName` string
    - `SubType` string
    - `Value` string
  - `DefaultStatusUpdatesMailAddress` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
    - `Id` integer
    - `TypeId` integer
    - `TypeName` string
    - `SubType` string
    - `Value` string
  - `DefaultPhone1` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
    - `Id` integer
    - `TypeId` integer
    - `TypeName` string
    - `SubType` string
    - `Value` string
  - `DefaultPhone2` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
    - `Id` integer
    - `TypeId` integer
    - `TypeName` string
    - `SubType` string
    - `Value` string
  - `DefaultFax` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
    - `Id` integer
    - `TypeId` integer
    - `TypeName` string
    - `SubType` string
    - `Value` string
  - `VatId` string — The vat-id, that should be saved at the customer. Only used if CustomerVatId is not set on the order.
  - `Type` integer — Customer Type
  - `MetaData` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel[]
    - `Id` integer
    - `TypeId` integer
    - `TypeName` string
    - `SubType` string
    - `Value` string
  - `ArchivedAt` string, date-time — If set, the customer was already archived at the given date. Further modification is disabled.
  - `RestoredAt` string, date-time — If set, the customer was restored from the archive at the given date.

## Response `200`

OK

- RechnungsdruckWebAppControllersApiApiResultOfBillbeeInterfacesBillbeeAPIModelCustomerApiModel
  - `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` BillbeeInterfacesBillbeeAPIModelCustomerApiModel
    - `Id` integer — The Billbee Id of the customer
    - `Name` string
    - `Email` string
    - `Tel1` string
    - `Tel2` string
    - `Number` integer
    - `PriceGroupId` integer
    - `LanguageId` integer
    - `DefaultMailAddress` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
      - `Id` integer
      - `TypeId` integer
      - `TypeName` string
      - `SubType` string
      - `Value` string
    - `DefaultCommercialMailAddress` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
      - `Id` integer
      - `TypeId` integer
      - `TypeName` string
      - `SubType` string
      - `Value` string
    - `DefaultStatusUpdatesMailAddress` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
      - `Id` integer
      - `TypeId` integer
      - `TypeName` string
      - `SubType` string
      - `Value` string
    - `DefaultPhone1` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
      - `Id` integer
      - `TypeId` integer
      - `TypeName` string
      - `SubType` string
      - `Value` string
    - `DefaultPhone2` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
      - `Id` integer
      - `TypeId` integer
      - `TypeName` string
      - `SubType` string
      - `Value` string
    - `DefaultFax` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel
      - `Id` integer
      - `TypeId` integer
      - `TypeName` string
      - `SubType` string
      - `Value` string
    - `VatId` string — The vat-id, that should be saved at the customer. Only used if CustomerVatId is not set on the order.
    - `Type` integer — Customer Type
    - `MetaData` BillbeeInterfacesBillbeeAPIModelsCustomerMetaDataApiModel[]
      - `Id` integer
      - `TypeId` integer
      - `TypeName` string
      - `SubType` string
      - `Value` string
    - `ArchivedAt` string, date-time — If set, the customer was already archived at the given date. Further modification is disabled.
    - `RestoredAt` string, date-time — If set, the customer 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)