Connect Your Inbox (Gmail OAuth)
Learn how to securely connect your Gmail or Google Workspace account to WarmOpener using OAuth2 authentication.
Why OAuth?
OAuth2 is the most secure way to connect Gmail accounts. Your password is never shared with WarmOpener. Instead, Google issues a secure token that allows us to send emails on your behalf.
Prerequisites
- A Gmail or Google Workspace account
- Admin access to grant permissions (for Google Workspace)
- 2-factor authentication enabled (recommended)
Step-by-Step Guide
1. Navigate to Inboxes
From your dashboard, click on Inboxes in the sidebar, then click the Connect Gmail button.
2. Authorize with Google
You'll be redirected to Google's OAuth consent screen. Review the permissions requested:
- Send email on your behalf: Required to send emails from your account
- View email messages: Required to track replies and engagement (future feature)
- View your email address: To display which account is connected
3. Complete Connection
After granting permissions, you'll be redirected back to WarmOpener. Your inbox will appear in the Inboxes list with an "Active" status badge and your email address displayed.
⚠️ Important: Gmail Sending Limits
Gmail has daily sending limits:
- Gmail free accounts: 500 emails/day (default limit set in WarmOpener)
- Google Workspace: 2,000 emails/day
You can adjust these limits in the Inboxes page to match your account type. To send more, connect multiple inboxes or upgrade your plan.
Token Management
WarmOpener automatically refreshes your OAuth tokens before they expire. Tokens are encrypted in the database using pgcrypto for security. If a token expires or is revoked, the inbox status will change to "Error" and you'll need to reconnect.
Troubleshooting
Connection Failed
If your connection fails, try these steps:
- Clear your browser cache and cookies
- Try using an incognito/private window
- Check that you're using the correct Google account
- For Workspace accounts, verify admin permissions are granted
- Ensure you're not at your plan's inbox connection limit
Reconnecting an Account
If you need to reconnect the same email address (e.g., after revoking access), simply click "Connect Gmail" again and select the same account. WarmOpener will update the existing connection instead of creating a duplicate.