Gmail

The Gmail integration connects your Google Workspace email to Sprigr Teams, giving your agents the ability to read incoming messages, send replies, search mailboxes, and manage labels. This is one of the most popular integrations for automating email-driven workflows.

Prerequisites

Before connecting Gmail, make sure you have:

A Google Workspace account (Gmail for business). Personal Gmail accounts (@gmail.com) are also supported but may have different rate limits.
Admin or Owner role in your Sprigr Teams organisation.

Connecting Gmail

Open the Integration Hub

Sign in to team.sprigr.com and click Integrations in the sidebar.
Find Gmail

Locate the Gmail card in the integration directory. Click Connect.
Authorise with Google

A Google sign-in window will appear. Select the Google account you want to connect and review the permissions Sprigr Teams is requesting. These include reading and sending email on your behalf.

Click Allow to grant access.
Verify the connection

Once authorised, the Gmail card will show a green “Connected” badge. You can now assign this integration to agents.

What syncs

Once connected, agents can interact with email in real time. The integration does not continuously sync your entire mailbox — instead, agents query Gmail on demand when they need to read or search emails. This means:

Reading — Agents can read specific emails or search for messages matching criteria (sender, subject, date range, labels).
Sending — Agents can compose and send new emails or reply to existing threads.
Labels — Agents can apply, remove, and list labels to help organise your inbox.

No emails are stored in Sprigr Teams. The agent reads directly from Gmail each time it needs information.

Available tools

When an agent has the Gmail integration enabled, it gains access to the following tools:

Tool	Action	Description
`gmail`	`search`	Search emails by query (sender, subject, keywords, date range, labels)
`gmail`	`read`	Read the full content of a specific email by ID
`gmail`	`send`	Compose and send a new email to one or more recipients
`gmail`	`reply`	Reply to an existing email thread
`gmail`	`manage_labels`	Create, apply, or remove labels from emails

Common use cases

Customer inquiry triage — An agent monitors incoming emails, categorises them by topic, and either responds directly or escalates to the right team member.
Automated follow-ups — An agent checks for unanswered emails older than a set number of days and sends a follow-up reply.
Email drafting — A team member asks an agent to draft a professional response to a customer complaint. The agent drafts the email and waits for approval before sending.
Report distribution — A workflow step uses the Gmail integration to email a weekly summary report to a distribution list.

Troubleshooting

“Access denied” during OAuth Your Google Workspace admin may need to approve Sprigr Teams as a trusted application. Ask your admin to check the third-party app access settings in the Google Admin console.

“Token expired” errors Sprigr Teams automatically refreshes OAuth tokens. If you see persistent token errors, try disconnecting and reconnecting the integration from the Integration Hub.

Agent cannot find emails Make sure the connected Google account has access to the mailbox the agent is searching. If you connected a shared mailbox, verify that delegation is properly configured in Google Workspace.

Emails going to spam Emails sent by agents through the Gmail integration come from your actual Gmail account, so they should not be flagged as spam. If recipients report spam issues, check that your domain’s SPF and DKIM records are correctly configured.

Next steps

Outlook — Connect Microsoft 365 email as an alternative or alongside Gmail.
Integrations Overview — See all available integrations.
Agent Settings — Assign the Gmail integration to specific agents.
Workflows — Use Gmail actions as steps in automated workflows.