Update customer

put https://app.ecwid.com/api/v3/{storeId}/customers/{customerId}

Update details of an existing customer in an Ecwid store.

Headers

Name	Type	Description
Authorization	string	oAuth token with mandatory `Bearer` before it. Example: `Bearer e*s0`, where `e*s0` should be replaced with your oAuth token.

Request body

A JSON object of type 'Customer' with the following fields:

Customer

Field	Type	Description
email	string	Customer email
password	string	Customer password
customerGroupId	number	Customer group ID
billingPerson	<Person>	Customer's billing name/address
shippingAddresses	Array<ShippingAddress>	Customer address book items (deprecated for new instant site customer accounts)
taxId	string	Customer tax ID
taxIdValid	boolean	`true` if customer tax ID is valid, `false` otherwise
b2b_b2c	string	Order type: business-to-business (`b2b`) or business-to-consumer (`b2c`)
fiscalCode	string	Fiscal code of a customer
electronicInvoicePecEmail	string	PEC email for invoices
electronicInvoiceSdiCode	string	SDI code for invoices
taxExempt	boolean	`true` if customer is tax exempt, `false` otherwise. Learn more
acceptMarketing	boolean	`true` if customer has accepted email marketing and you can use their email for promotions. If value is `false`, you can't use this email for promotions
lang	string	Customer's language code (based on the language of the storefront).

Person

Field	Type	Description
name	string	Customer full name
companyName	string	Customer company name
street	string	Street
city	string	City
countryCode	string	Country (2-digits code)
postalCode	string	Postal code (zip code)
stateOrProvinceCode	string	State/province code
phone	string	Phone number

ShippingAddress

Field	Type	Description
id	number	Internal address ID
name	string	Customer full name
companyName	string	Customer company name
street	string	Street
city	string	City
countryCode	string	Country (2-digits code)
postalCode	string	Postal code (zip code)
stateOrProvinceCode	string	State/province code
phone	string	Phone number

Response

A JSON object of type 'UpdateStatus' with the following fields:

UpdateStatus

Field	Type	Description
updateCount	number	The number of update customers (`0` or `1` depending on whether the request was successful)

Errors

In case of error, Ecwid responds with an error HTTP status code and JSON-formatted body containing error description.

HTTP codes

HTTP Status	Response JSON	Description
400	Request parameters are malformed
404	The customer with given ID is not found
409	The customer with the given email already exists
415	Unsupported content-type: expected `application/json` or `text/json`
500	The update request failed because of an error on the server

Error response body (optional)

Field	Type	Description
errorMessage	string	Error message

Language