createCustomerV2 mutation

The createCustomerV2 mutation creates a customer account. Use the createCustomerAddress mutation to complete the customer profile and define billing and shipping addresses.

The createCustomerV2 mutation supersedes the createCustomer mutation as the means to create a customer account. The input objects differ between these two mutations. The createCustomer mutation required the CustomerInput object, as did the updateCustomer mutation. The attributes required for creating a customer are different than those for updating a customer, but you could not determine this by looking at the schema. The createCustomerV2 mutation requires the CustomerCreateInput object, which it does not share with the updateCustomerV2 mutation.

Syntax

mutation: {createCustomerV2(input: CustomerCreateInput!) {CustomerOutput}}

Example usage

The following call creates a new customer.

Request:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
mutation {
  createCustomerV2(
    input: {
      firstname: "Bob"
      lastname: "Loblaw"
      email: "bobloblaw@example.com"
      password: "b0bl0bl@w"
      is_subscribed: true
    }
  ) {
    customer {
      firstname
      lastname
      email
      is_subscribed
    }
  }
}

Response:

1
2
3
4
5
6
7
8
9
10
11
12
{
  "data": {
    "createCustomer": {
      "customer": {
        "firstname": "Bob",
        "lastname": "Loblaw",
        "email": "bobloblaw@example.com",
        "is_subscribed": true
      }
    }
  }
}

Input attributes

The following table lists the attributes you can use as input for the createCustomerV2 mutation.

Output attributes

The CustomerOutput object contains the Customer object.

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

For B2B, company administrators and users can have the following attributes.

Errors

Related topics

• customer query
• updateCustomerV2 mutation
• createCustomerAddress mutation
• updateCustomerAddress mutation
• deleteCustomerAddress mutation