Using graphql storefront api mutations

3 0 1

I am testing and building a headless shopify using gatsby-shopify-starter template. (developing in React)

As far as I know I can easily query all the product and collection information with the help of 'gatsby-source-shopify'.


However I am having trouble using Storefront API, specially creating a customer using mutation.

I used gatsby-source-graphql plugin to build the admin graphql schema :


            resolve: `gatsby-source-graphql`,
            options: {
                typeName: 'ShopifyAdmin',
                fieldName: 'admin',
                url: ``,
                headers: {
                    'X-Shopify-Access-Token': process.env.SHOPIFY_SHOP_PASSWORD,
                fetchOptions: {
                    method: 'POST',



My question is: How would you be able to use mutation to the Do I need to install and use apollo client in order to use mutation?

Already tested with GraphiQL app and with Insomnia the following GraphQL query:


mutation customerCreate($input: CustomerCreateInput!) {
  customerCreate(input: $input) {
    customerUserErrors {
    customer {



Now how am I able to do this in my headless shopify-gatsby app using React? Are there any guides for it?

Replies 2 (2)

Shopify Partner
15905 2378 3087

Hello @young1c 

To use GraphQL mutations in your headless Shopify-Gatsby app using React, you don't necessarily need to install and use Apollo Client. While Apollo Client is a popular choice for GraphQL in React applications, you have other options as well, such as using the built-in `fetch` function or other GraphQL clients.

Here's a general approach to performing GraphQL mutations in a headless Shopify-Gatsby app:

1. Set up the GraphQL client: Choose a GraphQL client library or use the built-in `fetch` function to make HTTP requests. You can install libraries like `graphql-request`, `axios`, or use `fetch` directly.

2. Construct the GraphQL mutation: Define the mutation query in a separate file or directly in your React component. Use the `gql` tag from the `graphql-tag` library or similar tools to parse the GraphQL query.

3. Send the mutation request: Use the chosen GraphQL client to send the mutation request to the Shopify GraphQL API endpoint (``). Include the required headers, such as the `X-Shopify-Storefront-Access-Token`, to authenticate and authorize the request.

4. Process the response: Handle the response from the GraphQL mutation. You can check for errors in the response and extract the relevant data as needed.

As for guides and resources, Shopify provides comprehensive documentation on using GraphQL with their API. You can refer to the Shopify GraphQL API documentation, which covers various aspects of working with GraphQL in a Shopify context. Additionally, there are community-driven resources and tutorials available that specifically focus on using React and Gatsby with Shopify, which can provide step-by-step guidance on integrating and using mutations in your app.

Here are a few resources to get you started:

- [Shopify GraphQL API documentation](
- [Shopify Gatsby starter project](
- [Gatsby + Shopify tutorial](

These resources should provide you with the necessary information and examples to integrate GraphQL mutations in your headless Shopify-Gatsby app using React.


Get pass your Store Core Web Vital Free Speed Optimization Audit, Chat on WhatsApp | Skype : oscprofessionals-87 | Email: | Hire us | Guaranteed Site Speed Optimization | Website Free Audit | Shopify Theme Customization | Build Shopify Private App | Shopify SEO | Digital Marketing | Oscp Upsell & Cross sell App : Free | Oscp Sales & Volume Discount App : Free | Custom Pricing Wholesale App : Free
1 0 0

Is X-Shopify-Storefront-Access-Token the same PRIVATE_STOREFRONT_API_TOKEN?


I'm getting code UNAUTHORIZED error when I try to fetch in my local environment.