updateCustomer mutation

Edit on GitHub
Log an Issue

Magento recommends using the updateCustomerV2 mutation to update a customer.

The updateCustomer mutation updates the customer’s personal information.

To return or modify information about a customer, Magento recommends you use customer tokens in the header of your GraphQL calls. However, you also can use session authentication.

Syntax

mutation: {updateCustomer(input: CustomerInput!) {CustomerOutput}}

Example usage

The following call updates the first name and email address for a specific customer.

Request:

1
2
3
4
5
6
7
8
9
10
11
12
13

mutation {
  updateCustomer(
    input: {
      firstname: "Rob"
      email: "robloblaw@example.com"
    }
  ) {
    customer {
      firstname
      email
    }
  }
}

Response:

1
2
3
4
5
6
7
8
9
10

{
  "data": {
    "updateCustomer": {
      "customer": {
        "firstname": "Rob",
        "email": "robloblaw@example.com"
      }
    }
  }
}

Input attributes

The following table lists the attributes you can use as input for the updateCustomer mutation. The Customer attributes table lists the attributes Magento returns.

Attribute Data Type Description
date_of_birth String The customer’s date of birth. In keeping with current security and privacy best practices, be sure you are aware of any potential legal and security risks associated with the storage of customers’ full date of birth (month, day, year) along with other personal identifiers, such as full name, before collecting or processing such data.
dob String Deprecated. Use date_of_birth instead. The customer’s date of birth
email String The customer’s email address. Required to create a customer
firstname String The customer’s first name. Required to create a customer
gender Int The customer’s gender (Male - 1, Female - 2)
is_subscribed Boolean The customer’s new password
lastname String The customer’s last name. Required to create a customer
middlename String The customer’s middle name
password String The customer’s password. Required to create a customer
prefix String An honorific, such as Dr., Mr., or Mrs.
suffix String A value such as Sr., Jr., or III
taxvat String The customer’s Tax/VAT number (for corporate customers)

Output attributes

The updateCustomer mutation returns the CustomerOutput object.

The following table lists the top-level attributes of the customer object. See the customer query for complete details about this object.

Attribute Data Type Description
addresses CustomerAddress An array containing the customer’s shipping and billing addresses
created_at String Timestamp indicating when the account was created
date_of_birth String The customer’s date of birth. In keeping with current security and privacy best practices, be sure you are aware of any potential legal and security risks associated with the storage of customers’ full date of birth (month, day, year) along with other personal identifiers, such as full name, before collecting or processing such data.
default_billing String The ID assigned to the billing address
default_shipping String The ID assigned to the shipping address
dob String Deprecated. Use date_of_birth instead. The customer’s date of birth
email String The customer’s email address
firstname String The customer’s first name
gender Int The customer’s gender (Male - 1, Female - 2)
group_id Int Deprecated. This attribute is not applicable for GraphQL. The group assigned to the user. Default values are 0 (Not logged in), 1 (General), 2 (Wholesale), and 3 (Retailer)
id Int Deprecated. This attribute is not applicable for GraphQL.The ID assigned to the customer
is_subscribed Boolean Indicates whether the customer is subscribed to the company’s newsletter
lastname String The customer’s family name
middlename String The customer’s middle name
orders(<FilterCriteria>) [CustomerOrders] A list of the customer’s placed orders
prefix String An honorific, such as Dr., Mr., or Mrs.
reviews(pageSize: Int = 20 currentPage: Int = 1) [ProductReviews]! The list of reviews of the product
reward_points [RewardPoints] Details about the customer’s reward points
suffix String A value such as Sr., Jr., or III
taxvat String The customer’s Tax/VAT number (for corporate customers)
wishlist [Wishlist]! Contains the contents of the customer’s wish lists

Errors

Error Description
"input" value should be specified The input argument is empty.
"Email" is not a valid email address. The value provided in the input.email argument has an invalid format.
Provide the current "password" to change "email". To change an email address, specify the correct customer password in the password argument.
A customer with the same email address already exists in an associated website. You cannot apply a new email address to a current customer because another user has the same email address.
Invalid login or password. The value specified in the password argument is incorrect.
The current customer isn't authorized. The current customer is not currently logged in, or the customer’s token does not exist in the oauth_token table.
© 2021 Magento. All rights reserved.