Gmail: New Email Received

Trigger Communications

Triggers when a new email is received in your Gmail inbox. Polls your real Gmail account via OAuth — unlike the Email trigger which uses a disposable Pipedream inbox.

At a Glance

Field	Value
Trigger ID	gmail-new-email-received
Category	Communications
Tags	email, gmail, communication, notification, inbox

Trigger Configuration

Field	Type	Required	Description
labels	array	No	Only trigger for emails with these labels (optional)

Trigger Result

Field	Type	Required	Description
triggeredAt	string	Yes	Timestamp when the event was received (UTC, RFC3339 format)
from	string	No	Sender (From header value)
to	string	No	Recipients (To header value)
subject	string	No	Email subject line
text	string	No	Plain text body of the email
snippet	string	No	Short text preview of the email
threadId	string	No	Gmail thread ID
labelIds	array	No	Gmail label IDs on the message

Workflow Root Example

json
{  "nodes": {    "root": {      "type": "gmail-new-email-received",      "payload": {        "labels": []      },      "children": [        "log_event"      ]    },    "log_event": {      "type": "log",      "payload": {        "message": "Triggered at {{$trigger.triggeredAt}}"      },      "children": []    }  }}

Downstream nodes can use {{$trigger.triggeredAt}} and any result fields listed above. Event triggers usually expose the raw source payload under a field such as event, body, trade, or raw.