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

# Google Workspace

> Integrate with Google Workspace

<Info>We use Google Workspace's [OAuth](https://developers.google.com/identity/protocols/oauth2) support to integrate into your Workspace account. The workspace integration requires directory read permissions to be able to look up all users in your organization.</Info>

To get started, [add a new integration](https://app.wirespeed.co/settings/integrations?tab=browse) and select Google Workspace. You will be redirected to the OAuth Consent Page.

### Allow-listing Wirespeed emails in the Google Admin Console

You can add certain domains and email addresses to an allow-list across your Google Workspace. To ensure Wirespeed emails get to your team:

1. Sign in to the Google Admin Console at [https://admin.google.com](https://admin.google.com) using an administrator account.
2. In the left-hand menu, click **Apps** > **Google Workspace** > **Gmail**.
3. Ensure your domain is selected in the **Organizational Units** section.
4. On the **Spam, Phishing, and Malware** tab, locate the **Spam** section.
5. Click **Configure** (if no rules exist) or **Add another rule**.
6. Name your rule, and ensure the **Bypass spam filters and hide warnings for messages from senders or domains in selected lists** checkbox is checked.

<Warning>The **Bypass spam filters for internal senders** checkbox may be checked by default. It's NOT necessary to have this checked for our purposes and may add unwanted risk. Consider this before leaving it enabled.</Warning>

7. Click **Create or edit list** to open the Manage Address list page.
   * ***If creating a new list***, click **ADD ADDRESS LIST** name it accordingly, and select **Add Address**.
   * ***If editing an existing list***, select the list and click **Add Address**.

8. In the field provided, enter the domain: [wirespeed.co](https://wirespeed.co).

9. Click **SAVE**.

10. Return to the spam rule configuration page and click **Use existing list** and select the list you edited.

11. Click **Save** to apply the changes.

## Errors

### access\_not\_configured

<Warning>Access blocked: Your institution's admin needs to review Wirespeed. Error 400: access\_not\_configured</Warning>

This error occurs when your Google Workspace organization restricts third-party OAuth applications by default. This is a security feature in Google's Admin Console that requires an administrator to explicitly approve applications before users can grant them access.

To resolve this, a Google Workspace Super Admin must pre-approve the Wirespeed application:

1. Sign in to the [Google Admin Console](https://admin.google.com) as a Super Admin.
2. Navigate to **Security** > **Access and data control** > **API controls**.
3. Click **Manage Third-Party App Access** (or go directly to [App Access Control](https://admin.google.com/ac/owl/list?tab=apps)).
4. Click **Add app** > **OAuth App Name Or Client ID**.
5. Search for **Wirespeed** or paste the OAuth Client ID provided by your Wirespeed administrator.
6. Select the Wirespeed app and click **Select**.
7. Set the access level to **Trusted** (recommended) or **Limited**.
8. Click **Configure** to save.

Once the app has been approved, return to Wirespeed and retry the [Google Workspace integration](https://app.wirespeed.co/settings/integrations?tab=browse).

<Tip>If you are unsure of the OAuth Client ID, contact your Wirespeed account representative or email [support@wirespeed.co](mailto:support@wirespeed.co).</Tip>
