--- title: customerUpdate - Storefront API description: Updates an existing customer. api_version: 2025-10 api_name: storefront type: mutation api_type: graphql source_url: html: https://shopify.dev/docs/api/storefront/latest/mutations/customerUpdate md: https://shopify.dev/docs/api/storefront/latest/mutations/customerUpdate.md --- # customer​Update mutation Requires `unauthenticated_write_customers` access scope. Updates an existing customer. ## Arguments * customer [Customer​Update​Input!](https://shopify.dev/docs/api/storefront/latest/input-objects/CustomerUpdateInput) required The customer object input. * customer​Access​Token [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) required The access token used to identify the customer. *** ## Customer​Update​Payload returns * customer [Customer](https://shopify.dev/docs/api/storefront/latest/objects/Customer) The updated customer object. * customer​Access​Token [Customer​Access​Token](https://shopify.dev/docs/api/storefront/latest/objects/CustomerAccessToken) The newly created customer access token. If the customer's password is updated, all previous access tokens (including the one used to perform this mutation) become invalid, and a new token is generated. * customer​User​Errors [\[Customer​User​Error!\]!](https://shopify.dev/docs/api/storefront/latest/objects/CustomerUserError) non-null The list of errors that occurred from executing the mutation. * user​Errors [\[User​Error!\]!](https://shopify.dev/docs/api/storefront/latest/objects/UserError) non-nullDeprecated The list of errors that occurred from executing the mutation. *** ## Examples * ### customerUpdate reference ## Mutation Reference ```graphql mutation customerUpdate($customerAccessToken: String!, $customer: CustomerUpdateInput!) { customerUpdate(customerAccessToken: $customerAccessToken, customer: $customer) { customer { # Customer fields } customerAccessToken { # CustomerAccessToken fields } customerUserErrors { # CustomerUserError fields } } } ``` ## Input ```json { "customerAccessToken": "", "customer": { "firstName": "", "lastName": "", "email": "", "phone": "", "password": "", "acceptsMarketing": true } } ```