This is a beta release of documentation for Magento 2.4, published for previewing soon-to-be-released functionality. Content in this version is subject to change. Links to the v2.4 code base may not properly resolve until the code is officially released.

generateCustomerToken mutation

Use the generateCustomerToken mutation to create a new customer token.

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: {generateCustomerToken(email: String!password: String!) {CustomerToken}}

Example usage

The following call creates a new customer token.

Request:

1
2
3
4
5
6
7
8
mutation {
  generateCustomerToken(
    email: "bobloblaw@example.com"
    password: "b0bl0bl@w"
  ) {
    token
  }
}

Response:

1
2
3
4
5
6
7
{
  "data": {
    "generateCustomerToken": {
      "token": "ar4116zozoagxty1xjn4lj13kim36r6x"
    }
  }
}

Input attributes

The generateCustomerToken mutation requires the following inputs:

Attribute Data Type Description
email String The customer’s email address
password String The customer’s password

Output attributes

The generateCustomerToken mutation returns a valid token for the customer.

Attribute Data Type Description
token String The customer token

Errors

Error Description
Specify the "email" value. The value specified in the email argument is empty.
Specify the "password" value. The value specified value in the password argument is empty.
The account sign-in was incorrect or your account is disabled temporarily. Please wait and try again later. Authentication error. The email or password is incorrect, or the customer account is locked.