Updates a customer profile.
Open in API Reference
The ID of the customer to update.
A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field’s value.
''
The physical address associated with the customer profile. Only new or changed fields are required in the request.
For maximum length constraints, see Customer addresses. The first_name and last_name fields are ignored if they are present in the request.
first_name
last_name
The first line of the address.
Fields that start with address_line provide the address's most specific details, like street number, street name, and building name. They do not provide less specific details like city, state/province, or country (these details are provided in other fields).
address_line
The second line of the address, if any.
The third line of the address, if any.
A civil entity within the address's country. In the US, this is the state. For a full list of field meanings by country, see Working with Addresses.
A civil entity within the address's administrative_district_level_1. In the US, this is the county.
administrative_district_level_1
A civil entity within the address's administrative_district_level_2, if any.
administrative_district_level_2
The address's country, in the two-letter format of ISO 3166. For example, US or FR.
US
FR
Optional first name when it's representing recipient.
Optional last name when it's representing recipient.
The city or town of the address. For a full list of field meanings by country, see Working with Addresses.
The address's postal code. For a full list of field meanings by country, see Working with Addresses.
A civil region within the address's locality, if any.
locality
A civil region within the address's sublocality, if any.
sublocality
A civil region within the address's sublocality_2, if any.
sublocality_2
The birthday associated with the customer profile, in YYYY-MM-DD or MM-DD format. For example, specify 1998-09-21 for September 21, 1998, or 09-21 for September 21. Birthdays are returned in YYYY-MM-DD format, where YYYY is the specified birth year or 0000 if a birth year is not specified.
YYYY-MM-DD
MM-DD
1998-09-21
09-21
YYYY
0000
A business name associated with the customer profile.
The maximum length for this value is 500 characters.
The email address associated with the customer profile.
The maximum length for this value is 254 characters.
The family name (that is, the last name) associated with the customer profile.
The maximum length for this value is 300 characters.
The given name (that is, the first name) associated with the customer profile.
A nickname for the customer profile.
The maximum length for this value is 100 characters.
A custom note associated with the customer profile.
The phone number associated with the customer profile. The phone number must be valid and can contain 9–16 digits, with an optional + prefix and country code. For more information, see Customer phone numbers.
+
An optional second ID used to associate the customer profile with an entity in another system.
The tax ID associated with the customer profile. This field is available only for customers of sellers in EU countries or the United Kingdom. In other countries, this field is ignored when included in an UpdateCustomer request. For more information, see Customer tax IDs.
UpdateCustomer
The current version of the customer profile.
As a best practice, you should include this field to enable optimistic concurrency control. For more information, see Update a customer profile.
// No response received yet.