New email

Start the workflow when a new email arrives in Gmail: in the inbox, under a label, or matching a search.

A polling trigger

It checks for new items on a timer while the workflow is On, in the browser extension. Read Polling triggers for the first check, test events and what happens when a check fails.

Needs a New email connection — 

Pick a saved connection in the Connection field, or create one from there. It signs in with an OAuth2.

Create a connection →

What it does

Every Check every minutes, the trigger looks at the newest 25 emails of the Label (the inbox when empty) that match the Search, and starts one run with the ones it hasn’t seen yet.

A check that finds nothing new starts no run. Press Run to fetch a test event: the latest items, without moving the trigger’s position.

When to use it

• Save invoices from billing emails to Google Drive.
• Turn emails with a label into tasks.
• Get a notification when a specific sender writes.

Inputs and settings

设置项	类型	作用
Connection 必填（必填）	Credential
Label	Text	A Gmail label; empty = Inbox.
Search	Text	Gmail search words. Only matching emails start a run.
Check every	Number	At least 1 minute, only while the workflow is On. 默认值：5
On the first check	Choice	Options: Skip what’s already there, Start with the latest. 默认值：Skip what’s already there
How many to start with	Number	For “Start with the latest” and Fetch test event (1–20). 默认值：3

Search takes Gmail’s own search words, for example from:billing@example.com has:attachment. Only matching emails start a run.

Outputs

• Output

Each run returns a list of items with these fields:

Field	类型	What it holds
id	Text
threadId	Text
snippet	Text

Shape of an output item

[
  {
    "id": "…",
    "threadId": "…",
    "snippet": "…"
  }
]

One item per new email, with its id and the message details Gmail returns.

Dependencies and credentials

• Connection (connection, OAuth2): required. See Create a connection.

Example workflow

1. New email with Search has:attachment subject:invoice.
2. Gmail gets the attachment.
3. Google Drive uploads it to an Invoices folder.

Common issues

• It misses some emails: a check reads the newest 25 matching emails. With a busy inbox, check more often or narrow the Search.
• Not working on the connection: reconnect Gmail on the Connections page.

Related nodes

• Polling triggers: how every “New …” trigger checks.
• Gmail: send, read and label emails.
• Schedule Trigger: run at fixed times instead.