All integrations

Run agents with Gmail

Connect Gmail once, and every run that names it works in Gmail on the account you connected.

Connect GmailOpens Settings → Connections in the console.

What an agent can do in Gmail

Read, send and organise mail.

Jobs on Rush that use Gmail

Agents that use Gmail

How Gmail connects

Gmail is a built-in app: you sign in with your Google account on its own page, through Rush's own app, so you register no OAuth app. The sign-in asks only for the scopes listed below, and the run's token reaches gmail.googleapis.com, the Gmail REST API.

Connect it once in the console under Settings → Connections, or from your server with POST /me/connections. The sign-in finishes in a browser signed in to the console as the same person, and a link not finished within 10 minutes expires.

After that, a run that names gmail in connections, or runs a saved agent that names it, gets it; your connections reach no run that does not name them.

Scopes the sign-in asks for:

  • https://www.googleapis.com/auth/userinfo.email
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.send
  • https://www.googleapis.com/auth/gmail.modify
POST https://api.phoenix.so/me/connections

{
  "type": "app",
  "name": "gmail"
}

Whose Gmail account the agent uses

Your Gmail connection is personal: it belongs to the person who signed in. A run started in the console uses that person's Gmail, and a run started with an API key uses the Gmail of the member who created the key.

To act for your own app's users, make each user an agent from your template and show them, signed in to your app, the sign-in link POST /o/{org}/agents/{agent}/connections returns. They sign in to their own Gmail, and that agent's runs use their account and nothing else: never yours, never another user's.

More Productivity integrations

Frequently asked questions

How do I connect Gmail to Rush?

Open Settings → Connections in the console and connect Gmail, or send POST /me/connections with {"type":"app","name":"gmail"} and open the authorize_url it returns while signed in to the console. The connection reads pending until the sign-in finishes, then connected.

Does every run get my Gmail account?

No. A run gets your Gmail connection only when it names it in connections ("connections": ["gmail"]), or runs a saved agent that names it. A saved agent names its connections once, and every run of it gets them.

What can an agent do in Gmail?

Read, send and organise mail. 4 published jobs use it; this page lists them.

Can an agent only read Gmail?

Yes. A saved agent can name Gmail with an access level: read asks for reading alone, and send adds sending. An agent made from it signs in, and every run of it is refreshed, for that level alone.

Keep reading