# How to connect Gmail

> Connect your Gmail or Google Workspace inbox so OpenATS recovers your candidate conversations and keeps new replies attached.

Open **Settings → Integrations → Email inboxes** and choose **Connect Gmail**. OpenATS reads your past mail with candidates in the background, attaches each conversation to the right person, and keeps new replies coming in. It only stores mail with a candidate on it; everything else in your inbox is never kept.

*Integrations · Last updated 2026-11-11*

---

## Connect your inbox

1. Open **Settings → Integrations → Email inboxes**.
2. Choose **Connect Gmail**, and sign in with the Google account you recruit from.
3. Approve the access Google asks for. You’re brought back to OpenATS, and the history starts filling in.

Each recruiter connects their own inbox. You can also connect yours during [setup](https://openats.ai/docs/getting-started/set-up-your-workspace).

## What OpenATS reads and keeps

- It reads mail **only to match it to candidates**: a message is kept when it’s to or from a candidate’s email address, and matches exactly one candidate.
- Mail with anyone else, including your teammates, is never stored.
- It looks through your history first (people on open roles first, then recent applicants, then everyone else), then follows new mail as it arrives.
- Whenever someone new is added to OpenATS, every connected inbox looks back for earlier mail with them.
- A resume a candidate emails you, from the address OpenATS knows them by, is saved to their profile if they don’t have one yet.

While it works, the card counts its progress: **N% · X of Y candidates checked · … messages recovered · … emails scanned**. When it’s caught up: **N historical messages matched · New mail stays in sync**.

## What the card tells you

| The card says | It means |
| --- | --- |
| **Reads candidate email** | Your candidate conversations are syncing. |
| **Sends email** | Sequences and approved automatic emails can go from your own address. |
| **Calendar sync** | Interviews you schedule go on your Google Calendar. See [Google Calendar](https://openats.ai/docs/integrations/google-calendar). |
| **Reconnect Gmail** | Google needs you to sign in again, or a permission is missing. Reconnect to carry on. |

## Disconnect

Choose **Disconnect** on your inbox and confirm. OpenATS removes its access to your inbox; the conversations already recovered stay on the candidates. Admins can disconnect anyone’s inbox.

## Questions about connect Gmail

### Does OpenATS work with Outlook or Microsoft 365?

Not yet. Gmail and Google Workspace inboxes are the ones OpenATS can connect today.

### How long does the history take?

It depends mostly on how much candidate mail there is. The card shows how far it’s got, and you can keep working meanwhile. **Resync history** reads it again from the start.

### Can my teammates read my email?

Only mail with candidates is kept, and who sees it follows OpenATS’s access rules. Mail from your inbox shows on a candidate for people who can see that candidate’s applications. Nothing else from your inbox is stored.

---

Still need help? Write to the OpenATS team at https://openats.ai/support (or support@b150.ai). We reply by email.

Source: https://openats.ai/docs/integrations/connect-gmail
OpenATS help center: https://openats.ai/docs
