Toolkit›Suite›eCards›Connect Gmail (1-Click) - eCards
Setup

Connect Gmail (1-Click) - eCards

Live · Purchase Now
Send eCards cards directly from your Gmail address using secure 1-click OAuth authentication - no passwords or app passwords required.

Overview

eCards 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.

[!NOTE]
This uses Google's secure OAuth 2.0 flow. eCards 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 eCards
  • Pop-ups are allowed in your browser for eCards (required for the OAuth popup window)

Step 1: Go to Email Settings

  1. Log in to eCards
  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
  1. A Google sign-in popup will appear
  2. Select the Gmail account you want to connect
  1. Review the permissions and click Allow
[!WARNING]
eCards requests the https://mail.google.com/ scope. This is required by Gmail's SMTP OAuth2 protocol to send emails on your behalf. eCards 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.

Step 4: Send a Card

From now on, when you send a card:

  • eCards 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, eCards 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 eCards sending address.

Troubleshooting

The popup opens but closes immediately (white screen)
Make sure pop-ups are allowed for eCards in your browser settings. In Chrome: click the address bar lock icon -> Site settings -> Pop-ups and redirects -> Allow.
I see 'Access Denied' or 'App not verified'
eCards' Google OAuth app may still be pending Google verification. If you are on a test/staging environment, ask your eCards admin to add your email as a test user in the Google Cloud Console.
My Gmail is connected but cards are still sent from eCards' default address
Try disconnecting and reconnecting your Gmail account to refresh the token. If the issue persists, contact support.
[!NOTE]
Contact us if you have any questions or run into issues. We're happy to help!