> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.supersend.io/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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](https://help.supersend.io/en/article/senders-overview-vqg87v/) 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. ## Method 1: OAuth (Recommended for most teams) 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. - Your team can add **more than one** OAuth app (for example, separate Google Cloud projects or Workspace tenants). Pick the app that matches the mailbox you are connecting. - 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. 3. Click **Connect Your Gmail Account**. 4. Google's sign-in window opens in a new tab or popup. Sign in with the Gmail account you want to connect. 5. Review the permissions and click **Allow**. 6. 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](https://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. 3. Back in SuperSend, click **Next**. 4. 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"). 5. 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](https://help.supersend.io/en/article/create-and-use-sender-profiles-1g4rjqt/) 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). ## Related Articles - [Senders Overview](https://help.supersend.io/en/article/senders-overview-vqg87v/) - [Connect Outlook/Microsoft Sender](https://help.supersend.io/en/article/connect-outlook-microsoft-sender-1nh9x39/) - [Create and Use Sender Profiles](https://help.supersend.io/en/article/create-and-use-sender-profiles-1g4rjqt/)