Articles on: Senders

Connect Gmail / Google Workspace Sender

Connect Gmail / Google Workspace Sender


Purpose


Gmail and Google Workspace mailboxes are among the most common email senders used in SuperSend. This article covers all three connection methods: OAuth (recommended), App Password, and Service Account. Each method fits a different use case.


Before You Start


Connecting a Gmail mailbox is step one of a larger setup. After connecting, you'll need to attach the mailbox to a sender profile, and then assign that profile to a campaign before any email will send. If you haven't done this before, read Senders Overview first.


Open the Connection Wizard


  1. Go to Senders in the left sidebar.
  2. Click Add Sender (top right).
  3. Click Email Sender.
  4. On the method selection screen, click Connect Your Own Mailboxes.
  5. On the provider list, click Gmail.


You'll now see a screen with three tabs: OAuth, App Password, and Service Account. Choose based on your situation below.



OAuth connects Gmail without storing your password in SuperSend. Instead, SuperSend gets a scoped token from Google that can be revoked at any time. It's the most secure option and the easiest to set up if your team's Google OAuth app is already configured.


Steps:


  1. Click the OAuth tab (it's the default).
  2. You'll see a list of Google OAuth apps configured for your team. Click one to select it.
  • The "Default" badge marks the app your team has set as the standard.
  • An Active/Inactive indicator shows whether the OAuth app is currently working.
  1. Click Connect Your Gmail Account.
  2. Google's sign-in window opens in a new tab or popup. Sign in with the Gmail account you want to connect.
  3. Review the permissions and click Allow.
  4. You'll be redirected back to SuperSend. The mailbox appears in your sender list.


If no OAuth apps are listed: Your team hasn't set one up yet. Click Create OAuth App and fill in your Google Cloud credentials (Client ID, Client Secret, Project ID, and Redirect URI). You can upload a downloaded JSON file from Google Cloud Console to auto-fill these fields. Once saved, it will appear in the list.


Why you'd need this: OAuth apps are reusable across your entire team. One admin sets up the OAuth app once, and every team member uses it to connect their own Gmail.


Method 2: App Password


App passwords are Google-generated one-time passwords that let a specific app (SuperSend) access your Gmail without knowing your real password. This works when OAuth isn't available, or if your team prefers not to set up a shared OAuth app.


Prerequisite: Your Google account must have 2-Step Verification enabled. App passwords require 2SV.


Steps:


  1. Click the App Password tab.
  2. Follow the on-screen instructions to generate an app password in your Google account:
  • Go to myaccount.google.com/apppasswords (you need to be signed in).
  • Select "Mail" as the app and your device, or use a custom name like "SuperSend."
  • Google generates a 16-character password.
  1. Back in SuperSend, click Next.
  2. Enter:
  • Email Address — your full Gmail address.
  • App Password — paste the 16-character password from Google (spaces are fine, SuperSend strips them).
  • Send As Name — the display name that recipients will see (e.g., "Curtis Tryber").
  1. Click Connect Gmail.


Method 3: Service Account


Service Accounts are for Google Workspace (formerly G Suite) admins who need to connect multiple mailboxes without individual user sign-in. This uses Google's domain-wide delegation — the service account impersonates users on the domain.


This method is rarely needed unless you're a Workspace admin managing large-scale mailbox provisioning.


Steps:


  1. Click the Service Account tab.
  2. Enter the Email Address of the Google Workspace user you want to send from.
  3. Click Add Gmail.


Your Google Workspace admin must have already configured domain-wide delegation for SuperSend's service account in the Google Admin Console.


After Connecting


The mailbox now appears in Senders → Mailboxes tab with its email address and connection status.


To use it in campaigns, attach it to a sender profile:

  1. Go to Senders → Sender Profiles tab.
  2. Open a profile (or create one).
  3. Click Add Mailboxes on the profile detail page.
  4. Select this mailbox from the list.


See Create and Use Sender Profiles for the full walkthrough.


Re-Connecting a Mailbox


Gmail OAuth tokens can be revoked or expire (usually if you change your Google password or revoke access in your Google account settings). If this happens, the mailbox status in SuperSend will show as disconnected.


To reconnect, go to Senders → Mailboxes → find the mailbox → click the reconnect option, then follow the same OAuth or App Password steps above.


Expected Result


The Gmail mailbox appears in Senders → Mailboxes tab with an active status, and is available to attach to sender profiles.


Troubleshooting


  • Issue: OAuth consent screen shows "This app isn't verified" warning from Google.

Fix: This is expected for internal OAuth apps. Click "Advanced" → "Go to [app name] (unsafe)" to proceed. For production use at scale, submit your OAuth app for Google verification.


  • Issue: App Password option is greyed out or doesn't appear when generating it in Google.

Fix: 2-Step Verification must be enabled on your account before Google shows the App Password option.


  • Issue: Mailbox connects but immediately shows as disconnected.

Fix: Confirm that IMAP is enabled on the Gmail account (Gmail Settings → See all settings → Forwarding and POP/IMAP → IMAP access → Enable IMAP).



Updated on: 17/03/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!