Skip to main content
Update a customer’s information. Required Permission:
  • write_customers.
External DocumentationTo learn more, visit the Shopify documentation.

​
Basic Parameters

ParameterDescription
AddressesJSON array of address objects to set for the customer. All fields are optional.

For example:
[{
  “address1”: “Chestnut Street 92”,
  “address2”: “Apartment 2”,
  “city”: “Louisville”,
  “company”: null,
  “countryCode”: “US”,
  “firstName”: “Bob”,
  “lastName”: “Norman”,
  “phone”: “555-625-1199”,
  “provinceCode”: “QC”,
  “zip”: “40202”
}]
Note: For more information regarding the Addresses parameter, visit Shopify API documentation
Customer IDThe ID of the customer to update.

For example: gid://shopify/Customer/10079785100
Email AddressEmail address of the customer.
First NameFirst name for the customer.
Last NameLast name for the customer.
Phone NumberE.164 formatted phone number of the customer.

​
Advanced Parameters

ParameterDescription
LocaleThe customer’s locale.
MetafieldsJSON array of additional Metafields to associate to the customer.

For example:
[{
  “namespace”: “my_field”,
  “key”: “nickname”,
  “type”: “single_line_text_field”,
  “value”: “rob”
}]
Note: For more information regarding the Metafields parameter, visit Shopify API documentation
NoteAn note to save on the customer.

For example:
Placed an order that had a fraud warning.
TagsA comma-separated list of tags to add to this customer.

For example:
tag1,tag2,tag3
Tax ExemptWhen checked, the customer is exempt from paying taxes on their order.
Tax ExemptionsThe list of tax exemptions to apply to the customer.

Note: For more information about the Tax Exemptions parameter, visit Shopify API documentation

​
Example Output

{
	"customerUpdate": {
		"userErrors": [],
		"customer": {
			"id": "gid://shopify/Customer/1018520244",
			"firstName": "Tobi",
			"lastName": "Lutke"
		}
	}
}

​
Workflow Library Example

Update Customer with Shopify and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop