Skip to main content

​
Overview

CardClan supports connecting your personal Gmail account via OAuth 2.0. Once connected, all cards you send will arrive in your recipient’s inbox from your Gmail address, improving deliverability and personalisation.
This uses Google’s secure OAuth 2.0 flow. CardClan never stores your Gmail password — only an encrypted access token.

​
Prerequisites

Before connecting, make sure:
  • You have a Gmail account (e.g. yourname@gmail.com)
  • You are logged in to CardClan
  • Pop-ups are allowed in your browser for CardClan (required for the OAuth popup window)

​
Step 1: Go to Email Settings

  1. Log in to CardClan
  2. Click your profile icon or workspace name in the top navigation
  3. Go to Settings → Email Accounts

​
Step 2: Connect Your Gmail Account

  1. Scroll down to the One-Click OAuth Connections section
  2. Click the Connect Google button
Connect Google Button
  1. A Google sign-in popup will appear
  2. Select the Gmail account you want to connect
Google Account Selector
  1. Review the permissions and click Allow
CardClan requests the https://mail.google.com/ scope. This is required by Gmail’s SMTP OAuth2 protocol to send emails on your behalf. CardClan only uses this permission to send cards — it does not read, delete, or modify your emails.

​
Step 3: Confirm the Connection

After clicking Allow, the popup will close automatically and your Gmail address will appear under Connected OAuth Accounts with a green Google badge. Connected Gmail Account

​
Step 4: Send a Card

From now on, when you send a card:
  • CardClan will automatically use your connected Gmail address as the From address
  • No extra configuration is needed — it works automatically for all scheduled and instant sends
  • If your token expires, CardClan silently refreshes it in the background

​
Disconnecting

To remove the Gmail connection:
  1. Go to Settings → Email Accounts
  2. Find your Gmail under Connected OAuth Accounts
  3. Click Disconnect
Your account will be removed and cards will fall back to the default CardClan sending address.

​
Troubleshooting

Make sure pop-ups are allowed for CardClan in your browser settings. In Chrome: click the address bar lock icon → Site settings → Pop-ups and redirects → Allow.
CardClan’s Google OAuth app may still be pending Google verification. If you are on a test/staging environment, ask your CardClan admin to add your email as a test user in the Google Cloud Console.
Try disconnecting and reconnecting your Gmail account to refresh the token. If the issue persists, contact support.
Contact us if you have any questions or run into issues. We’re happy to help!