Resources · Zapier integration

Gmail Zapier integrationAutomate Gmail with Zapier.

The Gmail Zapier integration gives you 8 triggers, 12 actions and 2 searches. This page tells you what each one really does, what it costs on your plan, why none of them fires instantly, and which errors you will run into first.

See the 22 operations

Verified Trustpilot reviews · AI, automation & growth agency

Overview

What the Gmail Zapier integration actually does for you

It links your Gmail inbox to Zapier so that an email arriving, a label being added or a message being starred can set off work elsewhere, and so that other apps can send, reply, draft, label or archive mail in your account without you opening it. Nothing in your Gmail settings changes: Zapier only acts through the connection you grant it.

Three results people build first. A filing desk: New Attachment spots a file in your mail and hands it to your storage app. A triage line: New Email Matching Search catches the messages that fit a Gmail search, then Add Label to Email sorts them. A drafting helper: a form or a CRM record starts the Zap and Create Draft Reply leaves a reply waiting for your review.

What it does not do matters just as much. None of the 8 Gmail triggers is instant: every one is checked on a timer, so on the free plan a new email can wait up to 15 minutes before anything moves. And a Zap never goes back through your history: it only sees mail that lands after you switch it on, so the backlog is a separate job.

If you want to see the same app elsewhere, the Gmail n8n integration and the Gmail Make integration pages cover the same app on the other two platforms, if you would rather weigh the three tools side by side before building anything.

Vocabulary

Zapier vocabulary in one minute

Seven words come back on every line of this page. Here they are in plain English.

Zap
The automation you build: one starting event, then one or more steps that run each time that event happens.
Trigger
The event that starts the Zap, such as a new email. Once the Zap is on, Zapier sits and waits for it.
Action
What the Zap does once started: the step that sends, labels, drafts or moves something in your place.
Task
The unit Zapier bills you for: one action that completes successfully. Your plan is a count of these.
Polling vs instant
A polling trigger is checked on a timer for new items. An instant one is pushed to Zapier by the app the moment it happens.
Filter
A step that lets the Zap continue only when what arrived meets your condition, and stops it otherwise.
Search step
A step that looks up something already in an app, such as an existing email, so later steps can reuse it.
Cost

What a Gmail Zap really costs

Gmail is not a premium app, so it runs on the free plan. The bill comes from actions, never from the waiting.

  • Free plan100 tasks a month
  • Zaps on the free planUnlimited, two steps each
  • Gmail premium appNo
  • Instant Gmail triggers0 of 8

The trigger costs nothing, and neither does Zapier checking your inbox, however often it looks. Each action that goes through counts as one task, so a Zap that labels then forwards a message spends two. A failed action is not counted. The free plan stops at two steps: one trigger, one action. Add a filter, a search or a second action and you have a multi-step Zap, which needs a paid plan. Plan the shape of the Zap before the volume.

Connect

Connect Gmail to Zapier in 3 steps

  1. 01

    Open your connected apps

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

  2. 02

    Pick Gmail

    Type Gmail in the search box of the dialog, select it, then click Add connection. A new browser tab opens on the Google sign-in screen, where the next step happens.

  3. 03

    Sign in and grant access

    Log in with the Google account that owns the mailbox and allow Zapier to use it. You need your own Gmail account, plus read or write rights on any shared mailbox or label you do not own but want the Zap to touch.

First Zap

Your first Gmail Zap: forward and label invoices

GoalEvery email whose subject mentions an invoice is forwarded to your accountant, then labeled so you can find it later.

  1. 01

    Create the Zap and pick the trigger

    Start a new Zap, choose Gmail as the app and New Email as the event, then select the connection you created and the mailbox to watch.

  2. 02

    Test the trigger

    Run the test. Zapier brings back the three most recent emails of the account; pick one that really is an invoice so the next steps are mapped on real data.

  3. 03

    Add the filter

    Add a Filter step from the plus icon. Choose the subject field, a text rule, and the word invoice as the value to compare with. Only matching emails go further.

  4. 04

    Forward the email

    Add Gmail with Forward Email. Map the message from the trigger into the required Message field and type your accountant's address as recipient.

  5. 05

    Label it, then publish

    Add Add Label to Email with the same message and your Invoices label. Test each step, read what came back, then click Publish. This Zap has four steps, so it needs a paid plan.

Triggers

The 8 Gmail triggers

8 events start a Zap when something happens in Gmail. Zapier checks for them at the interval your plan allows.

1

New Attachment

Polling trigger

In Zapier“Triggers when you receive a new attachment.”

Starts your Zap each time an email with a file lands in your mailbox, and hands that file to the following steps so another app can store or process it.

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
you receive invoices, contracts or CVs as attachments and want each one copied to a shared drive without saving it by hand.
Watch out
an email with no file never sets it off, even if its subject says something is attached.
2

New Label

Polling trigger

In Zapier“Triggers when you add a new label.”

Reacts when a brand new label is created in your Gmail account. It watches the list of labels themselves, not the emails that carry them.

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
your team creates one label per client or per project and you want a matching folder, board or list to appear elsewhere as soon as the label exists.
Watch out
putting an existing label on a message does nothing here; that job belongs to the two labeled triggers below.
3

New Labeled Conversation

Polling trigger

In Zapier“Triggers the first time a label is added to a conversation. Replies within that conversation will not trigger again.”

Fires once per conversation, the first time the label you chose is added to it. Later replies in that same thread stay silent.

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 support or sales thread should open exactly one ticket or one deal, however long the back-and-forth runs afterwards.
Watch out
the label to watch is a required field, so it has to exist in Gmail before you set up the trigger.
4

New Labeled Email

Polling trigger

In Zapier“Triggers when an email is labeled. Also triggers when a reply is added to the conversation.”

Runs for every single email that gets your chosen label, and again whenever a reply joins that labeled conversation.

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
each message counts on its own, for example when every reply from a customer must be logged in your CRM.
Watch out
a setting lets Zapier read 1,000 changes per check instead of 500, but more than 100 new items in one check can be held by flood protection, so raise that limit too.
5

New Email

Polling trigger

In Zapier“Triggers when a new email appears in the specified mailbox.”

The broadest door into Gmail: any new message that shows up in the mailbox you point it at starts the Zap.

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 dedicated address such as orders or contact receives requests, and every one of them should create a record somewhere.
Watch out
on a busy inbox it fires a lot; pair it with a filter, or choose the search trigger below, so you do not spend tasks on newsletters.
7

New Starred Email

Polling trigger

In Zapier“Triggers when you receive a new email and star it within two days.”

Turns the star into a button: when you receive an email and star it within two days, the Zap picks it up.

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
you skim your inbox on your phone and want a single tap to send a message to your task manager for later.
Watch out
starring an old email does nothing; the two-day window after receipt is part of how this trigger is defined.
8

New Conversation

Polling trigger

In Zapier“Triggers when a new email conversations begins in your inbox.”

Fires when a fresh conversation begins in your inbox, and ignores the replies that pile up under it afterwards.

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
you want one lead or one ticket per new discussion, not one per message, so your other app stays readable.
Watch out
it watches your inbox only, so a conversation that never reaches the inbox does not set it off.
Actions

The 12 Gmail actions

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

1

Add Label to Email

Action

In Zapier“Add a label to an email message.”

Puts one or several labels on a message so it lands in the right place in your inbox.

When to use it
after a filter or a search has decided what kind of email it is, you sort it without touching it.
Watch out
the Label field picks from labels already in your account, so create them first, by hand or with Create Label.
2

Archive Email

Action

In Zapier“Archive an email message.”

Takes a message out of your inbox without deleting it: it stays in your account, out of sight.

When to use it
automatic notifications are logged elsewhere and do not need to clutter your inbox.
Watch out
the Message field is required, so the step needs a message handed over by an earlier Gmail trigger or search.
3

Delete Email

Action

In Zapier“Sends an email message to the trash.”

Sends a message to the Gmail trash instead of leaving it in your inbox or archive.

When to use it
one-time codes or alerts already copied elsewhere should not stay around.
Watch out
test it on a dummy email first; a wrongly mapped Message field trashes the wrong mail.
4

Create Draft

Action

In Zapier“Create a draft email message.”

Writes a brand new email and leaves it in your Drafts folder instead of sending it, so a human checks it first.

When to use it
a quote request arrives from your website and you want a prepared answer waiting for you.
Watch out
if you pick a plain-text body, switch on the HTML signature option or your signature loses its formatting.
5

Create Draft Reply

Action

In Zapier“Create a draft reply to an existing email.”

Prepares an answer inside an existing conversation and stops there, unsent, so the thread stays together.

When to use it
another tool writes a suggested reply and you want to read it before it leaves.
Watch out
the Thread field is required; map it from a Gmail trigger or search, never type a guess.
6

Forward Email

Action

In Zapier“Forward an existing email message to new recipients.”

Sends an email you already received on to new recipients, with the original files attached if you tick that option.

When to use it
supplier invoices go to your accountant without you opening them.
Watch out
the Message field is required and expects a real message from an earlier Gmail step.
7

Get Conversation

Action

In Zapier“Retrieves every message in a Gmail conversation by its thread ID.”

Fetches every message of a Gmail thread at once, so the next steps can read the full history, not just the latest reply.

When to use it
you send a whole discussion to a summary or CRM tool.
Watch out
it needs the thread ID from a previous Gmail step, so it comes after a trigger or a search that knows the conversation.
8

Create Label

Action

In Zapier“Creates a new label.”

Adds a new label to your Gmail account, ready to be put on messages by later steps or by hand.

When to use it
a new client signs in your CRM and gets their own label automatically.
Watch out
a slash in the name builds a nested label, such as clients/acme, so avoid slashes unless you want that hierarchy.
9

Send Email

Action

In Zapier“Create and send a new email message.”

Composes and sends a message from your own Gmail address, so replies come straight back to your inbox.

When to use it
a new booking or signup deserves a personal follow-up from you rather than from a marketing tool.
Watch out
the message needs at least one To, Cc or Bcc address; an empty mapped field makes the step fail.
10

Remove Label From Email

Action

In Zapier“Remove a label from an email message.”

Takes one or more labels off a single message and leaves the rest of the conversation as it was.

When to use it
a To process label should disappear once another app confirms the job is done.
Watch out
other emails in the same thread keep the label; use the conversation version to clear all of them.
11

Remove Label From Conversation

Action

In Zapier“Remove a specified label from all emails within a conversation.”

Clears a label from every email of a thread in one step, rather than message by message.

When to use it
a deal closes and the whole discussion should leave your Pending view.
Watch out
the Thread field is required, so the Zap must already know which conversation it is dealing with.
12

Reply to Email

Action

In Zapier“Send a reply to an email message.”

Answers in an existing thread and sends right away, keeping the conversation in one place for the person on the other side.

When to use it
an incoming request should get an immediate acknowledgment in the same thread.
Watch out
combined with an email trigger on the same inbox, check that your own reply cannot start the Zap again.
Searches

The 2 Gmail searches

2 search steps look for data that already exists in Gmail, so a later step can use it.

A search step looks for something that already exists in Gmail and passes it to the steps after it. In the editor, searches sit at the bottom of the Action event list, under SEARCH. Three settings decide what happens when the result is not what you expected.

1

Get Attachment by Filename

Search

In Zapier“Retrieves a specific Gmail message attachment by Filename.”

Goes into a known message and pulls out the file whose name you give, ready for an upload step.

When to use it
a trigger gave you the message, but only one of its files, say the PDF invoice, should be saved.
Watch out
the message ID and the filename are both required, and if two files share a name you also need their size to tell them apart.
2

Find Email

SearchFind or create

In Zapier“Finds an email message.”

Runs a Gmail search inside a Zap and returns the matching message, using the same operators as the Gmail search bar, such as from: or subject:.

When to use it
before replying, check whether a contact already wrote to you about the same order.
Watch out
the editor also lists Find or Send Email; it is this same search with the create box ticked, which sends a new email when nothing is found.

The three settings every search exposes

  1. Successful if no search results are found?
    Left as is, a search that finds nothing stops the Zap and the steps that depended on it are skipped. Switched on, the Zap carries on with nothing in hand.
  2. Create X if it doesn't exist yet?
    Ticking it turns the search into a find-or-create: the previous setting disappears and Zapier asks for the fields it needs to create the missing item.
  3. If multiple search results are found?
    Three choices when several items match: keep the first one, which is the default, stop the Zap, or pass all of them on together.
When it breaks

When a Gmail Zap breaks

Most Gmail failures come from the connection, from Google's own limits or from a field mapped with the wrong thing.

Zapier lists these errors in its help center under their exact message. Each one below points to the step to check first. For a wider method, the Zapier troubleshooting guide goes step by step.

  • The app returned “Unauthorized”

    Gmail refused the request Zapier made for you. Check the connection first: reconnect it from the Apps page, signing in with the account that owns the mailbox.

  • Quota exceeded: queries per minute per user

    The message names a per-minute, per-user cap on Gmail queries. It is a limit on Google's side, not the task count of your Zapier plan.

  • Invalid id value

    A Message or Thread field received a value Gmail does not accept as an ID. Those fields expect an ID: map it from an earlier Gmail trigger or search.

  • Nothing could be found for the search

    Find Email came back empty and stopped the Zap. Check the search string in Gmail itself, or turn on the setting that lets the Zap continue with no result.

  • Needs at least one To, Cc or Bcc address

    Send Email had no recipient on this run, for example because the mapped address came through empty. A filter that stops the Zap when the address is missing prevents it.

  • Old emails are never picked up

    A Zap only reacts to mail that arrives after you switch it on. Anything already in your inbox has to be handled separately, and a sudden flood can be held back by flood protection.
Need help

Need help automating Gmail with Zapier?

A person reads every message.

FAQ

Gmail Zapier integration: frequent questions

01Is the Gmail Zapier integration free?
Yes, as long as your Zap has two steps. Gmail is not a premium app, so it works on the free plan, which gives 100 tasks a month and an unlimited number of Zaps. The catch is the shape of the Zap: one trigger and one action, nothing more. As soon as you add a filter, a search such as Find Email, or a second action, the Zap becomes multi-step and Zapier asks for a paid plan. Many useful Gmail automations, such as forward then label, need that upgrade.
02How many tasks does a Gmail Zap use?
One per action that succeeds, and nothing for the trigger. Zapier can check your inbox as often as your plan allows without charging anything; only a completed action is billed. So a Zap with New Email followed by Forward Email and Add Label to Email spends two tasks for each email that goes through. An action that fails is not counted. Filters on busy inboxes save tasks, because emails stopped by the filter never reach the paid actions, but the filter itself makes the Zap multi-step.
03Is Gmail on Zapier real time?
No. All 8 Gmail triggers are polling triggers: Zapier asks Gmail for new items at a fixed interval, and that interval depends on your plan. It is 15 minutes on Free, 2 minutes on Professional and 1 minute on Team and Enterprise. The type comes from Gmail's side and cannot be changed in the editor. On paid plans you can adjust the interval and also run a check by hand from the editor when you are testing.
04What does it take to connect Gmail to Zapier?
A Google account that owns the mailbox, and a Zapier account. From the Apps page you click + Add connection, choose Gmail, sign in on Google in the new tab and grant Zapier access. If the Zap must touch a mailbox or labels you do not own, you also need read or write rights on them. Create in Gmail beforehand the labels your triggers and actions will use, since those fields pick from your account.
05Why does the Gmail search trigger also catch sent emails?
Because New Email Matching Search looks in every folder, sent mail included, unless you tell it otherwise. The fix sits in the search keywords: add an operator such as in:inbox to keep only incoming messages, exactly as you would in the Gmail search bar. Test the same string in Gmail first; what Gmail shows you there is what the trigger will pick up, minus anything that existed before the Zap was switched on.
06What if the Gmail action you need is not on the list?
Then it is not available in the Zapier editor today. The 12 actions and 2 searches on this page are the ones Zapier offers for Gmail; older operations it keeps in its data are hidden and cannot be picked. Often the result can be rebuilt by chaining what exists, for instance Find Email then Add Label to Email. If that is not enough, the same app on another automation platform may expose a different set of operations.
07Zapier, Make or n8n for Gmail?
It depends on your criteria, not on a single winner. On Zapier, Gmail runs on the free plan, its 8 triggers are all polling, and any Zap beyond one trigger and one action needs a paid plan. Make and n8n count usage and expose Gmail operations in their own way, so check those on their own pages. Compare how many emails you process each month, how fast a reaction must be, and who will maintain the automation before you choose.
Same platform

Other docs you might need on this stack.

Browse all integrations