- Home
- Resources
- Integrations
- CraftQL
CraftQL Make integrationAutomate CraftQL with Make.
Want your Craft CMS site to react to what happens in your other tools? The CraftQL Make integration gives you 3 action modules: Mutate, Query and Simple. This guide shows how to link your token, build a first scenario and pick the right module.
Verified Trustpilot reviews · AI, automation & growth agency
What can the CraftQL Make integration do for you?
The CraftQL Make integration links the CraftQL plugin of your Craft CMS site to Make, a tool where you build a scenario (the automation itself, a chain of modules) without code. Each module is one brick: here, three actions that talk to your site through the GraphQL token you create in CraftQL.
Feed your site from another tool. A marketing team collects entries in a form app; the scenario starts on that app, then hands each bundle (one item passed from module to module, such as one entry) to Mutate, the module whose GraphQL name points to writing data.
Pull site content into a report. An editor who wants a list of pages in a spreadsheet can start the scenario on a schedule and place Query, whose name points to reading data, before a module of another app.
A third module to explore. Simple completes the list. The official docs give no description for any of the three, so open each one in the editor and read the fields Make lists once your connection exists.
What Make does not give you here: no trigger, so CraftQL never starts a scenario by itself, and no universal Make an API Call module. The docs also say their CraftQL content is AI-generated and may contain mistakes, so double-check anything important with CraftQL. If the same app exists as an n8n node, the n8n vs Make page lays out how the two tools differ, and our Make review covers Make as a whole. Need a hand? The Make agency team builds these flows.
How do you connect CraftQL to Make?
- 01
Create a token in CraftQL
In your Craft CMS control panel, open the GraphQL section, click Tokens, then New token. Copy the API token shown in the Authorization Header section. You need Craft CMS 3.6.0 or later and the right to install plugins.
- 02
Add a CraftQL module in Make
Log in to Make, add any CraftQL module to your scenario and click Create a connection. A connection is your CraftQL account linked to Make once, then reused by every CraftQL module.
- 03
Paste the token and save
Give the connection a name in Connection name if you like, it is optional. Then paste the token you copied, or follow the on-screen instructions, and save. Make can now list what it reads on your site.
Your first scenario with CraftQL
GoalWhen a new entry lands in another app, Make passes it to CraftQL Mutate so your site receives the data.
- 01
Create the scenario
On the Scenarios page, create a new scenario and click the + to add the first module. Since CraftQL has no trigger, this first module comes from the app where your entries arrive.
- 02
Add the CraftQL module
Click the + on the right of the first module, search for CraftQL and pick Mutate. Click Create a connection and paste your token if you have not done it yet.
- 03
Fill the fields
Fill the fields of Mutate and map the data coming from the first module. Once the connection exists, Make lists what it can read on your site, so you pick instead of typing.
- 04
Test with Run once
Click Run once. Make executes the scenario one time and shows the bundles each module received. Open them to check that Mutate got what you expected before going further.
- 05
Schedule and switch on
Set the schedule on the first module with the clock. A new scenario runs every 15 minutes by default, and the Free plan cannot go below that. Then switch the scenario on.
What each CraftQL module does
CraftQL gives you 3 modules. For each one: what it does for you, when to reach for it, and what to watch out for.
Mutate
ActionIn the docs onlyMutate gets data from your scenario into your Craft CMS site. Its name comes from GraphQL, where a mutation writes rather than reads; the official docs add no description, so check the fields in the editor.
Query
ActionIn the docs onlyQuery hands you content from your site so the next modules can use it. In GraphQL, a query reads data, and that is what the name suggests; Make publishes no description, so confirm in the editor.
Simple
ActionIn the docs onlySimple is the third CraftQL action, and the only one whose name says nothing about reading or writing. The docs leave it undescribed, so add it to a test scenario and look at the fields Make offers.
Need help automating CraftQL with Make?
A person reads every message.