Gmail

Connect Gmail when a workflow or an agent should work in a mailbox: sort incoming mail, draft replies, send updates as your address, or start a run when a message arrives.

Who can connect it

An owner or admin connects Gmail once for the whole organization. A member asks one of them. Every workflow and agent then uses the same mailbox. To use two mailboxes, connect each one; each is its own connection. See Connecting apps.

Connect Gmail

1. Open the Apps page.
2. Press Connect an app.
3. Choose Gmail in the Super Connect window.
4. Sign in with the Google account of the mailbox and approve the access it asks for.
5. Finish when the window reaches Done.

Gmail is its own connection. Connecting it does not connect Google Sheets, Calendar or Drive. For a Google Workspace account, the Workspace column shows the account’s domain.

What you get

A Gmail connection brings actions and events. Actions search and read messages and threads, send mail, save drafts and manage labels. Events start a run when a message arrives, when the mailbox sends one, or when a label is added to a message. The live list of both is in the builder: the Action node’s picker for actions, and the Event list of an App event trigger for events. An agent uses only the actions you grant it. Action steps never offer a destructive action; an agent can be granted one, and it always waits for a member’s approval.

Good to know

• Super Connect checks Gmail every 10 minutes. A run can start up to 10 minutes after the mail arrives.
• The message received event watches the inbox. Set its label filter to watch another label instead.
• The from, to and subject filters match any part of the text, ignoring case.
• A Gmail trigger is checked every 10 minutes whether or not mail arrives. It counts as an active app subscription for as long as a live workflow uses it. See Allowances.
• Notification steps send from noreply@superflows.app. To send as your own address, use a Gmail action.

Caution

A workflow that sends mail from the mailbox it watches for sent messages starts itself again. Only your plan’s monthly run allowance stops such a loop, so add a Conditional step after the trigger that stops on mail the workflow sent.

Reauthorize Gmail

When the connection’s health reads failing or needs reauthorization, an owner or admin opens the Apps page, presses … on its row, then Reauthorize, and signs in again with the same Google account. The connection stays the same, so workflows, triggers and agent grants need no change. See Reauthorize a connection.