🔒 Update customer V3

patch

https://{xentralId}.xentral.biz/api/v3/customers/{id}

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: customer:update.

Update an existing customer.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Body Params

number

string

Customer number

deviatingDebtorAccountNumber

string | null

Deviating debtor account number for accounting

routingId

string | null

Routing ID (German: Leitweg-ID) used as the buyer reference on e-invoices. Takes precedence over the legacy free field 20.

mainProject

Main project the customer belongs to

primaryAddress

object

Primary address information for the customer

deviatingBillingAddress

Deviating billing address information. Set to null to delete the deviating billing address.

communication

object

Communication preferences and settings

financials

object

Financial information and settings

fulfillment

object

Fulfillment and delivery settings

documentDelivery

object

Document delivery preferences

accountManager

Account manager reference

salesManager

Sales manager with commission

originSalesChannel

Origin sales channel reference

groups

array of objects

Groups the customer belongs to

groups

customerRoles

array of objects

Customer roles associated with projects. All provided roles will be upserted.

customerRoles

customFields

array of objects

Custom fields for additional custom data

customFields

notes

string | null

Notes for the customer

200Update an existing customer.

400Failed validation

429Too Many Requests