> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cardclan.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Google Workspace (G Suite) via OAuth (1-Click)

> Send CardClan cards from your Google Workspace (G Suite) business email address using secure 1-click OAuth — no SMTP passwords needed.

## Overview

If your organisation uses **Google Workspace** (formerly G Suite) — for example `yourname@yourcompany.com` — you can connect it to CardClan using 1-click OAuth. Cards will be sent directly from your business email address.

<Info>
  This uses Google's secure OAuth 2.0 flow. CardClan never stores your password — only an encrypted access token.
</Info>

## Prerequisites

Before connecting, make sure:

* You have a **Google Workspace account** (e.g. `yourname@yourcompany.com`)
* Your **Google Workspace Admin** has not restricted third-party OAuth app access
* Pop-ups are **allowed** in your browser for CardClan

<Warning>
  If your Google Workspace organisation has restricted third-party app access, your admin must first approve CardClan. See the section below: **Google Workspace Admin Configuration**.
</Warning>

## Step 1: Go to Email Settings

1. Log in to [CardClan](https://app.cardclan.io)
2. Go to **Settings → Email Accounts**

## Step 2: Connect Your Google Workspace Account

1. Scroll to the **One-Click OAuth Connections** section
2. Click **Connect Google**
3. In the popup, sign in with your **Google Workspace email** (e.g. `yourname@yourcompany.com`)
4. Review the requested permissions and click **Allow**

<Warning>
  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 to send cards — it does not read, delete, or modify your emails.
</Warning>

## Step 3: Confirm the Connection

The popup closes automatically and your Google Workspace email appears under **Connected OAuth Accounts** with a **Google** badge.

## Step 4: Send a Card

All cards you send will now use your Google Workspace email as the **From** address automatically — for both instant and scheduled sends.

***

## Google Workspace Admin Configuration

If your organisation restricts third-party OAuth apps, your **Google Workspace Admin** must approve CardClan.

### How to approve CardClan as an Admin:

1. Sign in to [Google Admin Console](https://admin.google.com) with an admin account
2. Go to **Security → API controls → Manage third-party app access**
3. Click **Add app → OAuth App Name or Client ID**
4. Search for **CardClan** or enter the Client ID provided by your CardClan admin
5. Select the app and set access to **Trusted**
6. Click **Configure**

Once approved, users in your organisation can connect their Google Workspace accounts to CardClan.

***

## Disconnecting

1. Go to **Settings → Email Accounts**
2. Find your account under **Connected OAuth Accounts**
3. Click **Disconnect**

Cards will fall back to the default CardClan sending address.

## Troubleshooting

<AccordionGroup>
  <Accordion title="I get 'Access blocked: CardClan has not been granted access by your organization'">
    Your Google Workspace admin needs to approve CardClan as a trusted third-party app. Share the **Google Workspace Admin Configuration** section above with your IT admin.
  </Accordion>

  <Accordion title="The popup opens but shows a white screen or does not close">
    Allow pop-ups for CardClan in your browser. In Chrome: address bar → lock icon → Site settings → Pop-ups → Allow.
  </Accordion>

  <Accordion title="Cards are still sent from CardClan's default address after connecting">
    Disconnect and reconnect your account to issue a fresh token. Contact support if the issue continues.
  </Accordion>
</AccordionGroup>

<Info>
  [Contact us](mailto:hello@cardclan.io) if you need help or have questions.
</Info>