Step 1. Create a customer

This step creates a customer account and generates an authentication token for that customer. You can skip this step if you want to perform this tutorial as a guest user.

Create a customer

Use the createCustomer mutation to register the new customer account in the store.

Request:

Copy
mutation {
  createCustomer(
    input: {
      firstname: "John"
      lastname: "Doe"
      email: "john.doe@example.com"
      password: "b1b2b3l@w+"
      is_subscribed: true
    }
  ) {
    customer {
      firstname
      lastname
      email
      is_subscribed
    }
  }
}
Copied to your clipboard
mutation {
  createCustomer(
    input: {
      firstname: "John"
      lastname: "Doe"
      email: "john.doe@example.com"
      password: "b1b2b3l@w+"
      is_subscribed: true
    }
  ) {
    customer {
      firstname
      lastname
      email
      is_subscribed
    }
  }
}

Response:

Copy
{
  "data": {
    "createCustomer": {
      "customer": {
        "firstname": "John",
        "lastname": "Doe",
        "email": "john.doe@example.com",
        "is_subscribed": true
      }
    }
  }
}
Copied to your clipboard
{
  "data": {
    "createCustomer": {
      "customer": {
        "firstname": "John",
        "lastname": "Doe",
        "email": "john.doe@example.com",
        "is_subscribed": true
      }
    }
  }
}

The createCustomer mutation describes additional parameters.

Generate an authentication token for the customer

To place an order as a customer, you must obtain an authorization token by calling the generateCustomerToken mutation. You must include the customer's email and password as input.

Request:

Copy
mutation {
  generateCustomerToken(email: "john.doe@example.com", password: "b1b2b3l@w+") {
    token
  }
}
Copied to your clipboard
mutation {
  generateCustomerToken(email: "john.doe@example.com", password: "b1b2b3l@w+") {
    token
  }
}

Response:

Copy
{
  "data": {
    "generateCustomerToken": {
      "token": "zuo7zor5jfldft2nmu2gtylnm8ui7e8t"
    }
  }
}
Copied to your clipboard
{
  "data": {
    "generateCustomerToken": {
      "token": "zuo7zor5jfldft2nmu2gtylnm8ui7e8t"
    }
  }
}

Specify an Authorization header

To send requests on behalf of the customer, you must supply the generated token as a header in your GraphQL browser. The name of the header is Authorization and the value is Bearer <token>.

Authorization tokens describes the mutation further.

Verify this step

Sign in as a customer to the website using the email john.doe@example.com and password b1b2b3l@w+. You should be successfully logged in.

Last updated 9/8/2023

Was this helpful?

Yes

No