Gmail

Full Gmail integration for FlowRunner agents. Agents send and draft email, manage labels, save attachments to storage, and trigger flows on new messages, threads, and attachments.

5 triggers 19 actions available

An email with an attachment arrives and Gmail fires On New Attachment

Agent reads the message and identifies the attachment type

Agent confirms the sender and attachment match the expected intake criteria

Agent saves the attachment to flow storage and captures its URL

Agent passes the stored URL to a document processing step

Intake team notified that a new document is queued

Senders or attachments outside the expected pattern are routed to a person to triage

What This Integration Enables

Agents send and draft email, send existing drafts, and delete drafts and messages. They manage labels end to end: create labels, list them, and add or remove labels on messages for routing and organization. They read mail with actions to get a message, list messages by query, get message labels, and retrieve threads, and they mark messages read or unread. On attachments, agents get one or all attachments from a message and save an attachment into flow file storage, returning its URL. Five triggers fire on new emails, new threads, new labels, starred emails, and new attachments. The connector covers the mailbox surface; the surrounding flow decides what gets processed, ticketed, or answered.

Without FlowRunner

Manual sorting Incoming mail is read and routed by hand before any work can start

Attachments handled by hand Files are downloaded from email and uploaded into other tools manually

Replies wait on a person Even routine notifications wait for someone to compose and send them

With FlowRunner

Mail triggers the flow New emails, threads, and attachments start the right flow automatically

Attachments feed the pipeline Files are saved to storage and passed to processing without a manual download

Routine replies send themselves Notification and acknowledgment emails go out as a flow step

Use Case Scenarios

Invoice Attachment Intake

A vendor emails an invoice PDF and Gmail fires On New Attachment. The agent confirms the sender is a known vendor, calls Save Attachment to store the PDF in flow storage, and passes the returned URL to a document processing step that extracts the invoice data. The attachment moves from inbox to processing without anyone downloading and re-uploading it.

Support Email to Ticket

A support request lands and On New Email fires. The agent calls Get Message to read the body, extracts the key details, and creates a ticket in the issue tracker with the email content as the description. It applies a label so the thread is marked as handled. Inbound support becomes tracked work the moment it arrives.

Acknowledgment with a Human Gate for Unknowns

For recognized inbound patterns, the agent sends a templated acknowledgment with Send Message and labels the thread. When an email does not match any known pattern, the agent does not guess or auto-reply. It applies a triage label and routes the message to a person to decide how it should be handled.

Human-in-Loop Highlight

Not every email fits a known pattern, and the agent does not improvise on the ones that do not. When a message arrives from an unexpected sender or carries an attachment outside the intake rules, the agent holds it rather than acting, applies a triage label, and routes it to a person via Slack: "Email from [sender] with subject '[subject]' does not match any intake rule. Process as [best guess], route elsewhere, or ignore?" The person decides. Recognized mail flows through automatically; the edge cases get a human in the loop before the agent commits to a path.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via Slack

Human decides

Agent resumes with decision

Agent Capabilities

19 actions

Sending and Drafts

Send Message Composes and sends an email. Used to deliver acknowledgments, notifications, and transactional mail as a flow step.
Create Draft Creates a draft email without sending it. Used to prepare a message for human review before it goes out.
Send Draft Sends an existing draft. Used to release a reviewed draft once it is approved.
Delete Draft Deletes an existing draft. Used to clear drafts that are no longer needed.
Delete Messages Deletes one or more messages. Used in cleanup flows under a defined rule.

Reading Mail

Get Message Retrieves the content of a single message. Used to read an email body for extraction or ticketing.
Get Messages List Lists messages matching a query. Used to enumerate mail for batch handling or reporting.
Get Threads Lists or retrieves email threads. Used to gather a full conversation for context.
Get Message Labels Lists the labels applied to a message. Used to drive routing decisions on a message's current state.
Mark Message as Read Marks a message as read. Used to reflect that a flow has handled a message.
Mark Message as Unread Marks a message as unread. Used to flag a message back for human attention.

Labels

Create Label Creates a new Gmail label. Used to set up routing categories for a flow.
Get Labels Lists the labels in the mailbox. Used to confirm available categories before applying one.
Add Label To Message Applies a label to a message. Used to mark threads as handled, triaged, or routed.
Remove Label From Message Removes a label from a message. Used to clear a status once it no longer applies.

Attachments

Get Attachment Retrieves a single attachment from a message. Used to pull one specific file for processing.
Get Attachments Retrieves all attachments from a message. Used when a message carries multiple files to process.
Save Attachment Saves an email attachment into flow file storage and returns its URL. Used to move a file from the inbox into a processing pipeline without a manual download.
Get Drafts List Lists existing drafts. Used to review pending drafts in a review flow.

Triggers

5 triggers

Event Triggers

On New Email Fires when a new email arrives matching the configured criteria. Initiates flows that read, ticket, or acknowledge inbound mail.
On New Attachment Fires when a new email arrives carrying an attachment. Initiates intake flows that save the file and pass it to processing.
On New Thread Fires when a new email thread begins. Initiates flows that capture a new conversation, such as logging a sender to the CRM.
On New Label Fires when a new label is created. Initiates flows that react to organizational changes in the mailbox.
On Email Starred Fires when a message is starred. Initiates flows that act on messages a human has manually flagged.

Start building with Gmail

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us