Skip to content Docs index for AI agents (llms.txt)

DevelopersCustomersUpdate a customer

Update a customer

Change a customer of a shop with the API.

Updated 1 min read

This endpoint needs the Pro plan and works on the customers of the shop from the shop context. See the API overview for authentication and the rate limit.

PUT /customers/{id}

Send the fields as JSON. Returns 200 OK with the updated customer in data, in the same shape as in list customers.

Field Type Required Description
name string Yes Full name. Up to 255 characters.
is_company boolean Yes Whether the customer is a company.
company_name string No Up to 255 characters.
postal_code string No Up to 255 characters.
house_number integer No
house_number_addition string No Up to 255 characters.
street string No Up to 255 characters.
city string No Up to 255 characters.
country_id integer No Id of an existing country.
phone_number string No Up to 255 characters.
email string No A valid email address. Up to 255 characters.
invoice_email string No A valid email address. Up to 255 characters.
registration_number string No Chamber of Commerce number. Up to 255 characters. Can no longer be changed once the customer is linked to Peppol e-invoicing.
vat_number string No Up to 255 characters. Can no longer be changed once the customer is linked to Peppol e-invoicing.
codice_fiscale string No Italian tax code. Up to 255 characters.
remarks string No Free text. Up to 65535 characters.