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

# Enable Enhanced Gmail Monitoring

> Enhanced Gmail Monitoring allows GoGuardian Beacon to analyze emails sent through managed Google accounts, including emails sent from personal devices.

Enhanced Gmail Monitoring improves Beacon's ability to analyze emails sent through Gmail, producing more accurate alerts with fewer false positives. When enabled, Beacon can analyze emails sent from managed Google accounts regardless of the device used, including personal devices.

<Note>
  Enhanced Gmail Monitoring requires Beacon Core or Beacon 24/7 licensing. Only Super Users can complete this configuration.
</Note>

## Understand Enhanced Gmail Monitoring

Setup involves three steps completed across both Google Admin Console and Org Management:

1. Add Domain-Wide Delegation to Google Admin Console
2. Validate the Gmail API connection
3. Enable the Gmail API in Org Management

## Step 1: Add Domain-Wide Delegation

1. Go to [admin.google.com](https://admin.google.com) and sign in with your administrator account.

2. Navigate to [admin.google.com/ac/owl/domainwidedelegation](https://admin.google.com/ac/owl/domainwidedelegation).

3. Click **Add new** and enter the following:

   * **Client ID:** `112161068141953563053`
   * Select **Overwrite existing client ID**
   * Under **OAuth scopes**, enter: `https://www.googleapis.com/auth/gmail.readonly`

   Click **Authorize**.

4. Click **Add new** again and enter the following:

   * **Client ID:** `115924662447705174210`
   * Select **Overwrite existing client ID**
   * Under **OAuth scopes**, enter: `https://www.googleapis.com/auth/gmail.readonly`

   Click **Authorize**.

5. In Org Management, navigate to **Configuration > Product Settings > Beacon > Enhanced Gmail Monitoring**. Select the confirmation checkbox to confirm that both client IDs have been added.

<Note>
  Changes typically take 5–10 minutes to apply. In rare cases, propagation can take up to 24 hours.
</Note>

<img src="https://mintcdn.com/goguardian/s7oOcyDCDvZb2ExZ/images/screenshots/enhanced-gmail-monitoring/step-01.png?fit=max&auto=format&n=s7oOcyDCDvZb2ExZ&q=85&s=b55f2d2764d38ca96f02358e6354c60d" alt="Domain wide delegation setting in Google Admin Console highlighting the &#x22;add new&#x22; button" width="1292" height="902" data-path="images/screenshots/enhanced-gmail-monitoring/step-01.png" />

## Step 2: Validate the Gmail API

After completing Step 1, verify that the connection between GoGuardian and Google is working correctly.

1. In Org Management, click **Step 2: Validate Gmail API** under the Enhanced Gmail Monitoring tab.

2. Enter the email address of a student in your organization.

3. If validation is unsuccessful, an error message appears. Wait a few hours and try again. If validation is successful, proceed to Step 3.

## Step 3: Enable the Gmail API

1. In Org Management, toggle **Turn Gmail API on** under the Enhanced Gmail Monitoring tab.

Enhanced Gmail Monitoring is now active. Beacon will begin analyzing emails sent from managed Google accounts.

<img src="https://mintcdn.com/goguardian/s7oOcyDCDvZb2ExZ/images/screenshots/enhanced-gmail-monitoring/step-02.png?fit=max&auto=format&n=s7oOcyDCDvZb2ExZ&q=85&s=8cc131999bf0f5caaa15143bd7aa6aee" alt="&#x22;Enable Gmail API&#x22; setting drawing attention to the &#x22;Turn Gmail API on&#x22; toggle" width="1358" height="230" data-path="images/screenshots/enhanced-gmail-monitoring/step-02.png" />

## Resources

<CardGroup cols={2}>
  <Card title="Configure Beacon Settings" href="/products/beacon/configure-beacon-settings">
    Overview of all Beacon configuration options in Org Management.
  </Card>

  <Card title="How Beacon Works" href="/products/beacon/how-beacon-works">
    Overview of Beacon's detection and alert system.
  </Card>

  <Card title="Alert Card Anatomy (24/7)" href="/products/beacon/alert-card-anatomy-247">
    Understand the components of a Beacon 24/7 alert card.
  </Card>

  <Card title="Initial Setup Checklist" href="/products/beacon/initial-setup-checklist">
    Complete setup steps for deploying GoGuardian Beacon.
  </Card>
</CardGroup>
