Frequently Asked Questions

Product Information & GraphQL Mutations

What is Hygraph's GraphQL Mutations API?

Hygraph's GraphQL Mutations API allows you to programmatically create, update, delete, and publish content entries for any model in your project. These mutations are automatically generated for each content model and are secured by a flexible permissions API. This enables developers to build dynamic features such as upvoting products, managing content workflows, and more. Learn more at the Hygraph Mutations API documentation.

How do I use GraphQL Mutations in Hygraph to manage content?

You can use GraphQL Mutations in Hygraph to create, update, delete, and publish content entries for your models. For example, you can allow users to upvote products by creating a Vote model and using the createVote and publishVote mutations. These operations can be performed via serverless functions or directly through the API Playground. For detailed examples, see the official blog post and documentation.

Can I automate content publishing workflows with Hygraph?

Yes, Hygraph supports automated content publishing workflows using its GraphQL Mutations API. You can programmatically create content in draft mode and then publish it using the publish mutation. This is useful for scenarios like user-generated content, editorial workflows, or integrating with external systems. See the API reference for more details.

How can I modify the contents of my project using Hygraph?

You can use the GraphQL Mutations API to create, update, delete, and publish content within your project. This can be done individually or in bulk, and is accessible via the API Playground or programmatically through your application. For more information, visit the Hygraph Features page.

What capabilities does the Hygraph Mutations API offer?

The Hygraph Mutations API allows you to create, update, delete, and publish content from outside the UI. It provides a fully typed GraphQL API for various implementation ideas, such as letting users vote on their favorite product or managing editorial workflows. Learn more at the Hygraph Examples page.

Features & Capabilities

What features does Hygraph offer?

Hygraph offers a GraphQL-native architecture, content federation, scalability, and a wide range of integrations. Key features include a powerful GraphQL API, intuitive user interface, robust permissions, enterprise-grade security, and support for automation and bulk operations. For a full list of features, visit the Hygraph Features page.

What integrations are available with Hygraph?

Hygraph integrates with platforms such as Netlify, Vercel, BigCommerce, commercetools, Shopify, Lokalise, Crowdin, EasyTranslate, Smartling, Aprimo, AWS S3, Bynder, Cloudinary, Mux, Scaleflex Filerobot, Ninetailed, AltText.ai, Adminix, and Plasmic. For a complete list, visit the Hygraph Integrations page.

Does Hygraph provide an API for content management?

Yes, Hygraph provides a powerful GraphQL API for fetching and managing content efficiently. You can learn more about the API at the Hygraph API Reference.

How does Hygraph optimize content delivery performance?

Hygraph emphasizes optimized content delivery performance, which directly impacts user experience, engagement, and search engine rankings. By ensuring rapid content distribution and responsiveness, Hygraph reduces bounce rates and increases conversions. For more details, visit this page.

Pricing & Plans

What is Hygraph's pricing model?

Hygraph offers a free forever Hobby plan, a Growth plan starting at $199/month, and custom Enterprise plans. For more details, visit the pricing page.

Security & Compliance

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 Compliant, ISO 27001 Certified, and GDPR compliant. These certifications ensure the highest levels of data protection and security for users. For more details, visit the Hygraph Security Features page.

How does Hygraph ensure data security and compliance?

Hygraph provides enterprise-grade security features such as SSO integrations, audit logs, encryption at rest and in transit, and sandbox environments to protect sensitive data and meet regulatory standards. For more information, visit the Hygraph Security Features page.

Use Cases & Benefits

Who can benefit from using Hygraph?

Hygraph is ideal for developers, IT decision-makers, content creators, project/program managers, agencies, solution partners, and technology partners. It is especially beneficial for modern software companies, enterprises looking to modernize their technologies, and brands aiming to scale across geographies or improve development velocity. (Source: ICPVersion2_Hailey.pdf)

What business impact can customers expect from using Hygraph?

Customers can expect significant business impacts, including time-saving through streamlined workflows, ease of use with an intuitive interface, faster speed-to-market for digital products, and enhanced customer experience through consistent and scalable content delivery. (Source: ICPVersion2_Hailey.pdf)

What problems does Hygraph solve?

Hygraph addresses operational pains (e.g., reliance on developers for content updates, outdated tech stacks, conflicting needs from global teams), financial pains (e.g., high operational costs, slow speed-to-market, expensive maintenance, scalability challenges), and technical pains (e.g., boilerplate code, overwhelming queries, evolving schemas, cache problems, OpenID integration challenges). For more details, visit the product page.

What are some real-world success stories of customers using Hygraph?

Komax achieved a 3X faster time to market, Autoweb saw a 20% increase in website monetization, Samsung improved customer engagement with a scalable platform, and Dr. Oetker enhanced their digital experience using MACH architecture. More case studies are available on the Hygraph Case Studies page.

Which industries are represented in Hygraph's case studies?

Hygraph's case studies span industries such as Food and Beverage (Dr. Oetker), Consumer Electronics (Samsung), Automotive (AutoWeb), Healthcare (Vision Healthcare), Travel and Hospitality (HolidayCheck), Media and Publishing, eCommerce, SaaS (Bellhop), Marketplace, Education Technology, and Wellness and Fitness. See more at the case studies page.

Technical Requirements & Documentation

Where can I find technical documentation for Hygraph?

Comprehensive technical documentation for Hygraph is available at hygraph.com/docs. It covers everything you need to know about building and deploying projects with Hygraph.

How easy is it to get started with Hygraph?

Hygraph is designed to be easy to start with, even for non-technical users. Customers can sign up for a free-forever account and use resources like documentation, video tutorials, and onboarding guides. For example, Top Villas launched a new project in just 2 months from the initial touchpoint. Learn more at Hygraph Documentation.

Support & Implementation

What customer support is available after purchasing Hygraph?

Hygraph offers 24/7 support via chat, email, and phone. Enterprise customers receive dedicated onboarding and expert guidance. All users have access to detailed documentation, video tutorials, and the community Slack channel. For more details, visit the Hygraph Contact Page.

What training and onboarding resources does Hygraph provide?

Hygraph provides onboarding sessions for enterprise customers, 24/7 support, training resources such as video tutorials, documentation, webinars, and access to Customer Success Managers for expert guidance. For more details, visit the Hygraph Contact Page.

Customer Proof & Case Studies

Who are some of Hygraph's customers?

Hygraph is trusted by leading brands such as Sennheiser, Holidaycheck, Ancestry, Samsung, Dr. Oetker, Epic Games, Bandai Namco, Gamescom, Leo Vegas, and Clayton Homes. For more details and customer stories, visit the Hygraph Case Studies page.

Performance & Metrics

What KPIs and metrics are associated with the pain points Hygraph solves?

Key metrics include time saved on content updates, number of updates made without developer intervention, system uptime, speed of deployment, consistency in content across regions, user satisfaction scores, reduction in operational costs, ROI on CMS investment, time to market for new products, maintenance costs, scalability metrics, and performance during peak usage times. For more details, visit the Hygraph blog on CMS KPIs.

Velocity at Scale: Join the Launch of Hygraph’s Latest AI Innovations

Create, Update, Delete, and Publish Content with GraphQL Mutations

Whether you're building a static website, eCommerce store, Content Hub, or Mobile App, Hygraph powered GraphQL Mutations will bring your project to life.
Jamie Barton

Written by Jamie 

Jul 15, 2020
GraphQL Mutations with GraphCMS

Since the very beginning, Hygraph has boasted a GraphQL Mutations API alongside the traditional Query Content API, and it's free!

One of the biggest benefits of working on the Jamstack is that you get to pick the best of breed APIs. Whether you're building a static website, eCommerce store, Content Hub, or Mobile App, Hygraph powered GraphQL Mutations will bring your project to life.

For each model you create in your project, Hygraph automatically generates a mutation to create, update, delete, publish, and unpublish your content entries (records). These mutations are also backed up by a flexible, and secure permissions API.

Imagine we have a list of products, and we want to allow users to "upvote" products. The UI could look something like this:

Upvote products on click

You can also try this for yourself here.

To make this possible, you might reach for a serverless function, and you can easily build serverless functions with Next.js API routes. Here's a taste of what that looks like to create and publish votes for our products:

// https://github.com/hygraph/hygraph-examples/blob/master/using-mutations/src/pages/api/upvote.js
import { GraphQLClient } from 'graphql-request';
export default async ({ body }, res) => {
const hygraph = new GraphQLClient(
process.env.HYGRAPH_ENDPOINT,
{
headers: {
authorization: `Bearer ${process.env.HYGRAPH_MUTATION_TOKEN}`,
},
}
);
const { createVote } = await hygraph.request(
`mutation upvoteProduct($id: ID!) {
createVote(data: { product: { connect: { id: $id } } }) {
id
}
}`,
{ id: body.id }
);
res.status(201).json({ id: createVote.id });
};

On each request we send a GraphQL mutation to our Hygraph endpoint with the id as a variable from the body of the request payload.

We are using connect to tell Hygraph which product we want to reference when creating a new Vote. The createVote mutation is automatically generated for us when we create a model named Vote.

In the function above we are just creating an upvote, but what about if we want to publish this too? By default, Hygraph only returns PUBLISHED content, so when we call createVote, we'll be creating a DRAFT record.

Client to Hygraph request flow

If we want to show the new vote count, we can also call the publishVote mutation after we create it!

await hygraph.request(
`mutation publishUpvote($id: ID!) {
publishVote(where: { id: $id }, to: PUBLISHED) {
id
}
}`,
{ id: createVote.id }
);

You can read more about all that is possible with the Hygraph Mutation API over at the docs.

Have fun!

Blog Author

Jamie Barton

Jamie Barton

Jamie is a software engineer turned developer advocate. Born and bred in North East England, he loves learning and teaching others through video and written tutorials. Jamie currently publishes Weekly GraphQL Screencasts.

Share with others

Sign up for our newsletter!

Be the first to know about releases and industry news and insights.