βοΈ Connect Email with SMTP/IMAP in Search Atlas
To send outreach emails through Search Atlas, you must connect your Gmail account using SMTP/IMAP with an App Password.
π¨ Important
Regular Gmail passwords will NOT work. Search Atlas requires a Google App Password. Using your regular password will always fail!
β Confirmed Fix (resolves 90%+ of cases)
- Enable 2-Factor Authentication on your Google account.
- Create an App-Specific Password and use it in Search Atlas (not your normal Gmail password).
This is a setup requirement, not a bug.
π Step 1 β Enable 2-Step Verification
- Go to: https://myaccount.google.com
- Click Security
- Enable 2-Step Verification
π Step 2 β Create an App Password
- Go to: https://myaccount.google.com/apppasswords
- Select: App: Mail
- Device: Other β "Search Atlas"
- Click Generate
- Copy the password β οΈ This is NOT your Gmail password.
βοΈ Step 3 β Enable IMAP
- Open Gmail
- Go to Settings β See all settings
- Go to Forwarding and POP/IMAP
- Enable IMAP
π Step 4 β Connect in Search Atlas
- Go to: Authority Building β Campaigns
- Click: Manage Connected Emails β + Add New Email
- Select: Configure SMTP/IMAP
- Enter: Email β your Gmail / Password β App Password
- Click Connect
π Where is this used?
Connecting your email enables outreach campaigns inside the Digital PR tool.
π See how it works in context: π Digital PR Tool β Overview & Functionality
β Common Errors
- "Authentication failed" π You used your normal Gmail password. β Use App Password instead.
- "Connection error" π IMAP not enabled. β Enable IMAP in Gmail settings.
- "Still not working" π Most commonly 2FA is not enabled, OR you generated the App Password before enabling 2FA. β Enable 2-Step Verification FIRST, then generate a fresh App Password.
π¨ Most users get stuck here
If your email is not connecting, 90% of the time it's because:
β You're using your Gmail password instead of an App Password.
Make sure you generate and use an App Password from Google.
Once connected, you can:
- Send outreach emails
- Receive replies inside Search Atlas
- Manage conversations in the Inbox
π Related Known Issues
Users connecting Gmail for outreach frequently encounter these adjacent issues. If any apply, please open a separate ticket referencing the IDs below so we can track them properly:
- Report Builder β Competitors not showing: Confirmed bug, currently being worked on by engineering (internal ticket GitLab #16861). Support can provide status updates on request.
- OTTO SEO schema causing Google errors: Known issue under investigation by the technical team. Please share the affected URL and a screenshot of the Google error with support so it can be attached to the open ticket.
- Billing quota reset date: Your billing cycle and quota reset on your own subscription billing day each month (the day your plan renews, clamped to the last day in shorter months) β confirm your specific date in the Avatar Menu (π€) (Avatar Menu (π€), top-right) β Billing.