<- Customers API

Customers API

All versions ->

Update customer

PUT

/v2/customers/{customer_id}

Updates a customer profile.

To change an attribute, specify the new value. To remove an attribute, specify the value as an empty string or empty object.

As a best practice, you should include the version field in the request to enable optimistic concurrency control. The value must be set to the current version of the customer profile.

To update a customer profile that was created by merging existing profiles, you must use the ID of the newly created profile.

You cannot use this endpoint to change cards on file. To make changes, use the Cards API or Gift Cards API.

Permissions:CUSTOMERS_WRITE

Guide

Update a customer profile

Try in API Explorer

Link to section

Path parameters

Example code

Link to section

customer_id

string

Required

The ID of the customer to update.

Link to section

Request body

Link to section

given_name

string

The given name (that is, the first name) associated with the customer profile.

Link to section

family_name

string

The family name (that is, the last name) associated with the customer profile.

Link to section

company_name

string

A business name associated with the customer profile.

Link to section

nickname

string

A nickname for the customer profile.

Link to section

email_address

string

The email address associated with the customer profile.

Link to section

address

The physical address associated with the customer profile.

Link to section

phone_number

string

The 11-digit phone number associated with the customer profile.

Link to section

reference_id

string

An optional second ID used to associate the customer profile with an entity in another system.

Link to section

note

string

A custom note associated with the customer profile.

Link to section

birthday

string

The birthday associated with the customer profile, in RFC 3339 format. The year is optional. The timezone and time are not allowed. For example, 0000-09-21T00:00:00-00:00 represents a birthday on September 21 and 1998-09-21T00:00:00-00:00 represents a birthday on September 21, 1998. You can also specify this value in YYYY-MM-DD format.

Link to section

version

integer(64-bit)

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.

Link to section

Response fields

Link to section

errors

Any errors that occurred during the request.

Link to section

customer

The updated customer.