> Index of every Falcon docs page, for assistants: https://falcon.com/docs/llms.txt

# Gmail

Read, label, draft and send mail in the signed-in Gmail mailbox, and start a workflow when that mailbox changes.

This is the Gmail app on **Apps**. A workflow that only drafts replies uses **Connect Gmail** or **Connect your own Gmail**. That mailbox is separate, and this app does not take its place.

## What it can do

- Read: **Get mailbox**, **List messages**, **Get message**, **Get attachment**, **List threads**, **Get thread**, **List labels**, **List drafts**, **Get draft** and **List history**.
- Change the mailbox: **Change message labels**, **Move message to trash**, **Restore message from trash**, **Change thread labels**, **Create draft**, **Update draft**, **Delete draft**, **Create label**, **Watch mailbox** and **Stop mailbox watch**.
- Send outside the company: **Send message**, **Reply to a message** and **Send draft**.

Every call is the signed-in mailbox. One list is one page, not the whole mailbox. Trash can be restored. This app does not delete mail forever. **Send draft** uses the change permission below, not the send-only permission.

## What can start a workflow

- **Mailbox history**, **Message added**, **Message deleted**, **Label added** and **Label removed**.
- The notice names the mailbox and a history id. It does not include the mail. **List history** reads what changed, from the history id saved before.
- **Watch mailbox** lasts under 7 days. Renew it at least daily. **Stop mailbox watch** ends it.

## How to connect

Open **Connections**, then **Apps**. In the **Apps** heading, search with **Search apps to add** and choose **Add** on Gmail.

When the panel offers **Who signs in**, pick **Sign in as the company (one account for every agent)** or **Each person signs in to their own account when first needed**.

Read what it asks for. If it has not said, the panel says **You'll see what Gmail asks for on its own sign-in page.** Choose **Continue to Gmail** and finish there. Do not paste a password into Studio. When it works, the row says **Connected**.

If it says **This app can't be connected here yet: it needs a sign-in setup this server doesn't have.** or **Connecting Gmail opens soon on this server.**, this server cannot sign Gmail in yet. If you do not see **Add**, ask an admin to add Gmail.

## What it asks for

- Read mail, labels, drafts and history (`gmail.readonly`). It does not send.
- Send a message (`gmail.send`). It does not read mail, and it does not send a draft.
- Change labels, move mail to trash, and work with drafts, including sending a draft (`gmail.modify`). It does not delete mail forever.
- It does not ask for full mailbox access (`https://mail.google.com/`).

## Related

- [Outlook](https://falcon.com/docs/app-outlook)
- [Google Calendar](https://falcon.com/docs/app-google-calendar)
- [Connections](https://falcon.com/docs/connections)