Resources · Zapier integration

Grist Zapier integrationAutomate Grist with Zapier.

The Grist Zapier integration gives you 4 triggers, 3 actions and 1 search. All of it works on records: catch the new or changed rows of a table, write rows from other apps, and find an existing row before any step touches it.

Verified Trustpilot reviews · AI, automation & growth agency

Overview

What the Grist Zapier integration does

It connects your Grist documents to Zapier, so that a row added or changed in a table starts an automation, and so that other apps can write rows into Grist for you. Grist is not a premium app, so it runs on the free plan. One condition: this integration only talks to Grist's standard hosted service, not to a copy you host yourself.

The single most useful thing to know first: each Grist event comes in two versions. New Record and New or Updated Record wait for Zapier's scheduled check; their Instant twins are pushed by Grist the moment the row changes, on any plan. Pick the Instant one unless you have a reason not to.

Three results people build. Rows that copy themselves: a registration lands in one table and Create Record files it into another. A table that stays deduplicated: Create or Update Record matches on the fields you choose and edits the row instead of adding a twin. A lookup before a write: Find Record fetches the exact row a later step should change.

What it does not do: there is no visible action to delete a record, nothing at the document or table level, and no catch-up on rows that existed before the Zap went live. Comparing tools? The Grist n8n integration and Grist Make integration pages use the same layout.

Vocabulary

Zapier vocabulary in one minute

Seven terms come back throughout. Here they are once, in plain words.

Zap
The automation you build: one starting event, then one or more steps that run every time that event happens.
Trigger
The Grist event that starts the Zap, such as a new row. Once the Zap is on, Zapier waits for it by itself.
Action
What the Zap does once started: the step that creates, updates or writes a record for you.
Task
Zapier's billing unit: one action that completes successfully. Your plan's allowance counts these, not Zaps.
Polling vs instant
Polling: Zapier asks Grist for new rows on a timer. Instant: Grist calls Zapier as soon as the row changes.
Filter
A step that lets the Zap continue only when the row meets your condition, and stops it quietly otherwise.
Search step
A step that finds a record already in a table, so the steps after it can read or change that exact row.
Cost

What it really costs

The trigger is free. Every row you write is not.

  • Premium appNo, works on the free plan
  • Free plan100 tasks a month, two-step Zaps
  • Instant triggersNew Record (Instant), New or Updated Record (Instant)
  • HostingGrist's standard hosted service only

A Grist trigger never costs a task, polling or instant, and Zapier's checks are free too. You pay one task for each action that completes, so a Zap with two actions uses two tasks each time both succeed. Failed actions are not billed. The free plan gives you 100 tasks a month and unlimited Zaps, but each Zap stops at two steps: one trigger and one action. A filter, a Find Record step or a second action makes it multi-step, which requires a paid plan.

Connect

Connect your Grist account

  1. 01

    Open Apps

    In Zapier, go to the Apps page of your account and click + Add connection. A connection is your Grist account linked once, then reused by every Zap that touches Grist.

  2. 02

    Pick Grist

    Search for Grist in the dialog, select it and click Add connection. A tab opens where you sign in to Grist, on the hosted service this integration supports.

  3. 03

    Allow access

    Grant Zapier access to your account. Back in Zapier, the connection shows up in your list, and each Grist step lets you pick it from its account menu.

First Zap

Your first Zap: file paid registrations as attendees

GoalWhen a new row lands in the Registrations table and it is marked as paid, create or update the matching row in the Attendees table.

  1. 01

    Create the Zap

    From your Zapier dashboard, start a new Zap. The editor opens on the first step, the trigger, which is always where a Zap starts.

  2. 02

    Set the instant trigger

    Choose Grist and New Record (Instant), your connection, then the Team, the Document and the Registrations table. The lightning bolt on the card shows it is instant.

  3. 03

    Test on a real row

    Run the test. Zapier brings back the three most recent rows of the table; add one first if it is empty, then pick it so the next steps map real values.

  4. 04

    Keep only paid rows

    Click the plus icon and add Filter: your payment column, a text rule, the value paid. The Zap is now multi-step, so it needs a paid plan.

  5. 05

    Write the attendee

    Add Create or Update Record on the Attendees table, choose the email column as the field to match on, and map the columns from the registration row.

  6. 06

    Test and publish

    Test the action, check Attendees in Grist, then publish the Zap. Writing into a different table from the one you watch is what keeps it from looping.

Triggers

Grist triggers

4 events start a Zap when something happens in Grist, and 2 of them are instant: the app calls Zapier straight away, whatever your plan.

1

New Record

Polling trigger

In Zapier“Triggers when a new record is created.”

Watches one table and starts the Zap for every row added to it. This is the scheduled version: it waits for Zapier's next check rather than being told.

How it fires
Zapier goes and looks at regular intervals, and how often depends on your plan: every 15 minutes on the free one.
When to use it
a small warehouse logging incoming stock where a short delay before the reorder sheet updates is fine.
Watch out
New Record (Instant) covers the same event without the wait; prefer it unless you have a reason to poll.
2

New Record (Instant)

Instant trigger

In Zapier“Triggers when a new record is created.”

Same event as New Record, a row added to the table you pick, but Grist pushes it to Zapier itself, so the next steps run without waiting.

How it fires
the app tells Zapier the moment it happens, so the Zap starts right away, whatever your plan.
When to use it
an event organiser who wants each registration confirmed while the attendee still has the page open.
Watch out
Team, Document and Table are all required, so one Zap follows one table; a second table means a second Zap.
3

New or Updated Record

Polling trigger

In Zapier“Triggers when a record is created or updated.”

Catches rows that are created and rows that are edited afterwards, on a schedule. It is the trigger for tracking a status that moves inside a table.

How it fires
Zapier goes and looks at regular intervals, and how often depends on your plan: every 15 minutes on the free one.
When to use it
a research lab tracking samples, where each status change should be logged in a separate history table.
Watch out
if the same Zap writes back into this table, every write counts as an update and the Zap restarts itself in a loop.
4

New or Updated Record (Instant)

Instant trigger

In Zapier“Triggers when a record is created or updated.”

The pushed version of New or Updated Record: Grist reports the creation or the edit of a row the moment it is saved, and the Zap carries it on.

How it fires
the app tells Zapier the moment it happens, so the Zap starts right away, whatever your plan.
When to use it
a support team that flips a ticket row to escalated and wants the on-call person told right then.
Watch out
every edit fires it, including small corrections; add a filter on the column that really matters.
Actions

Grist actions

Grist gives you 3 actions. For each one: what it does for you, when to reach for it, and what to watch out for.

1

Create or Update Record

Action

In Zapier“Creates a new record in a table, or updates an existing matching record.”

Looks for a row that matches on the destination columns you pick, edits it if found, and creates it if not. One step instead of a search plus a write.

When to use it
keeping one row per customer or per product, however many times the source sends it.
Watch out
at least one field to match on is required; choose a column whose values are unique.
2

Create Record

Action

In Zapier“Creates a new record in a table.”

Adds a new row to the table you choose, filling its columns with values mapped from earlier steps.

When to use it
a contact form, an order or a booking from another app becomes a clean row in Grist.
Watch out
it always adds a row, even if an identical one already exists, so run it on a table you do not mind growing.
3

Update Record

Action

In Zapier“Updates an existing record.”

Changes an existing row you point it to, leaving the rest of the table alone.

When to use it
a payment confirmed elsewhere should tick the matching invoice row in Grist.
Watch out
the Record field is required, so it needs to know which row; a Find Record step just before usually supplies it.
Searches

Grist search

1 search step looks for data that already exists in Grist, so a later step can use it.

A search step finds a row that already exists so later steps can use it. Searches sit at the bottom of the Action event list, under their own SEARCH heading. Three settings decide what happens when the result is not the one you expected.

1

Find Record

SearchFind or create

In Zapier“Finds a record in a table.”

Picks out a row of a table by the value of one column and hands it to the steps that follow.

When to use it
right before Update Record, to give it the exact row. The editor also lists Find or Create Record: it is this same search with the creation box ticked, not an extra operation.
Watch out
Team, Document, Table and Column are all required.

The three settings every search exposes

  1. Successful if no search results are found?
    Left on its default, a search that finds nothing stops the Zap and skips the steps that depended on it. Switch it on and the Zap carries on empty-handed.
  2. Create Record if it doesn't exist yet?
    Ticking this turns Find Record into Find or Create Record: the setting above disappears and Zapier asks for the columns needed to create the missing row.
  3. If multiple search results are found?
    Three ways out when several rows match: keep the first, which is the default, stop the Zap, or hand every match on at once.
When it breaks

When it breaks

Zapier attaches no help article to Grist. These are the general limits that bite a table first.

Before blaming Grist, check how the Zap reads the table. Check the four cases below before rebuilding anything, and keep in mind that only the standard hosted service connects. When a run history still shows errors you cannot place, our Zapier troubleshooting guide walks through the method.

  • Existing rows never come through

    A Zap reacts only to what happens after you switch it on. Rows already in the table stay put; moving them is a separate job.
  • Writing to the watched table loops

    A Zap that writes into the table its own trigger watches sets itself off on every write, especially with New or Updated Record, and burns tasks fast.
  • A bulk import gets held back

    When a table suddenly returns a huge batch, after an import or a paste of many rows, Zapier's flood protection can hold the run back.
  • A polled row is not sent twice

    On the polling triggers, Zapier remembers the rows it has already seen, so the same new row does not start the Zap a second time.
Need help

Need help automating Grist with Zapier?

A person reads every message.

FAQ

Grist and Zapier: common questions

01Is the Grist Zapier integration free?
Yes. Grist is not a premium app on Zapier, so you can use it on the free plan. That plan includes 100 tasks a month and unlimited Zaps, but every Zap is limited to two steps: one trigger and one action. A new row copied into another table fits. As soon as you add a filter, a Find Record step or a second action, the Zap becomes multi-step and needs a paid plan to be switched on.
02How many tasks does a Grist Zap consume?
One per action that completes, and nothing for the trigger. Zapier's checks on your tables are free as well, however frequent. A Zap that creates one row uses one task per run. A Zap with two actions uses two per run when both succeed. Failed actions are not counted. Create or Update Record is handy here: it matches and writes in a single action, where a search plus an update would take two steps.
03Does Grist trigger Zaps in real time?
It depends on which trigger you pick. New Record (Instant) and New or Updated Record (Instant) are pushed by Grist the moment a row changes, so the Zap starts right away on any plan. New Record and New or Updated Record are polling triggers: Zapier checks every 15 minutes on the free plan, every 2 minutes on Professional, and every minute on Team and Enterprise. For the same event, the Instant version is usually the better choice.
04What does connecting Grist to Zapier require?
A Grist account on the standard hosted service, since this integration does not reach a self-hosted Grist, and a Zapier account. You add the connection once from the Apps page, sign in to Grist in the tab that opens and grant access. Every Grist step asks for a Team, a Document and a Table, so the account you connect must be able to open them. For a document someone else owns, get shared access first.
05Why does a Grist Zap keep running on its own?
Almost always because it writes into the table its trigger is watching. With New or Updated Record, every update the Zap makes counts as a new change, which fires the Zap again, and the loop eats your tasks quickly. The fix is structural: write into a different table, or add a filter that lets through only the rows the Zap did not touch itself. Check the run history to confirm the pattern before changing anything.
06What if the Grist operation you need is not there?
This page lists every visible Grist operation on Zapier: four triggers, three actions and one search, all about records. There is no action to delete a row and nothing that works on whole documents or tables. Unlike some apps, Grist offers no generic API request step here, so the realistic option is to check whether another automation tool covers the missing step, which is what our n8n and Make pages for Grist are for.
07Zapier, Make or n8n for Grist?
Decide by criterion rather than by a general ranking. Operations: on Zapier, Grist covers records only, so check what the other tools offer for documents and tables. Speed: on Zapier, two Grist triggers are instant and two follow your plan's polling delay. Billing: Zapier counts completed actions, never the trigger. Hosting: this Zapier integration reaches only the hosted Grist. Our n8n and Make pages for Grist follow the same structure, which keeps the comparison quick.