Connect Google Workspace

There are two ways to connect a Google Workspace (or personal Gmail) mailbox: OAuth, which is one click, and an app password over SMTP/IMAP, which takes a few minutes of setup. Use OAuth when it's offered; use the app password path when it isn't, or when your admin restricts third-party OAuth apps.

Option 1: OAuth (one click)

When OAuth connect is available for your account, choose Google in the Add mailbox flow, sign in, and approve access. No passwords, hosts, or ports to enter — EmailWarmer gets exactly the access it needs and you're done. Skip straight to configuring warmup.

Option 2: App password over SMTP/IMAP

Prerequisites

• 2-Step Verification enabled on the Google account. Google only issues app passwords to accounts with 2FA turned on — this is a Google requirement, not ours.
• IMAP enabled in Gmail. Go to Gmail → Settings → See all settings → Forwarding and POP/IMAP → enable IMAP. Without this, the IMAP half of the connection test fails even with correct credentials.

Create the app password

1. Go to myaccount.google.com/apppasswords (you may be asked to sign in again).
2. Enter a name like "EmailWarmer" and click Create.
3. Google shows a 16-character password once. Copy it — you can't view it again, only revoke it and create a new one.

Enter the settings

In the Add mailbox flow, choose SMTP/IMAP and enter:

Turn on use same credentials so IMAP reuses the same login. Enter your sender name (the From name on warmup mail), then run the connection test — it performs a real SMTP verification and IMAP login before saving anything.

Troubleshooting

"535 Authentication Failed" or similar SMTP errors

• You're using your normal account password instead of an app password. Google rejects regular passwords for SMTP — an app password is required.
• The app password was mistyped or includes stray spaces. Revoke it and create a fresh one.
• 2-Step Verification was turned off after the app password was created — Google invalidates existing app passwords when 2FA is disabled.

Can't find the App Passwords page

The page only exists when 2-Step Verification is on. Enable it under Google Account → Security → 2-Step Verification first, then return to myaccount.google.com/apppasswords. On some Workspace accounts, admins disable app passwords entirely — ask your admin, or use OAuth instead.

SMTP passes but IMAP fails

Almost always IMAP is disabled in Gmail settings. Enable it (see prerequisites above), wait a minute, and re-run the connection test.

Next steps

Once connected, configure your daily volume, working hours, and reply rate — the settings reference covers each option — and start warmup.