## **🔍 Overview**

Search Atlas integrates with Google Search Console (GSC) and Google Business Profile (GBP) using OAuth — a secure token-based authorization system. When these tokens expire, are revoked, or become invalid, your integrations will disconnect automatically. This article explains the most common causes and the steps you can take to restore a stable connection.

## **⚠️ Why Integrations Keep Disconnecting**

There are several reasons your Google integrations may disconnect repeatedly:

- **Revoked OAuth tokens:** If access permissions are revoked in your Google Account settings, Search Atlas loses authorization immediately. This is the most common cause of repeated disconnections.
- **Expired tokens:** Google OAuth tokens have a limited lifespan. If Search Atlas cannot automatically refresh a token (for example, due to a permission change), the connection will drop.
- **Password or security changes:** Changing your Google account password or enabling two-factor authentication can invalidate existing tokens.
- **Multiple Google accounts:** Connecting Search Atlas with more than one Google account, or switching between accounts during setup, can cause token conflicts and unstable connections.
- **Third-party access revoked at the Google level:** Google periodically prompts users to review connected apps. If Search Atlas access was removed during one of these reviews, you will need to reconnect.

## **✅ How to Check Your Google Account Permissions**

Before reconnecting inside Search Atlas, verify that access has not been revoked at the Google level:

1. Go to **myaccount.google.com** and sign in with the Google account linked to Search Atlas.
2. Navigate to **Security** in the left-hand menu.
3. Under **Third-party apps with account access**, click **Manage third-party access**.
4. Look for **Search Atlas** in the list. If it is missing or shows a revoked status, you will need to re-authorize it when you reconnect.
5. If Search Atlas is listed, remove it and reconnect fresh to clear any corrupted token state.

## **🔄 How to Reconnect Google Search Console**

1. Log in to your Search Atlas account.
2. Navigate to **Site Metrics → Site Explorer** and click **Open Google Search Console** to reach the **Manage Sites** page.
3. Locate the **Google Search Console** integration and click **Disconnect** if it shows a connected or error state.
4. Click **Connect GSC Account** and follow the OAuth prompts.
5. Make sure you select the correct Google account and grant **all requested permissions** — partial permission grants are a common cause of token issues.
6. Confirm the integration status shows **Connected** before closing the settings page.

## **🗂️ How to Reconnect Google Business Profile**

1. Log in to your Search Atlas account.
2. Navigate to **Settings** and select **Integrations**.
3. Locate the **Google Business Profile** integration and click **Disconnect**.
4. Navigate to **Local → GBP Projects**, click **Connect GBP Account**, and complete the OAuth authorization flow.
5. Ensure you grant access to all business locations you manage — if a location's access is missing, features like review sync and auto-responder will not function for that location.
6. Verify the integration status shows **Connected** and check that your locations appear correctly.

## **💡 Best Practices to Prevent Future Disconnections**

- **Use a dedicated Google account** for Search Atlas integrations where possible, rather than a personal account that may be subject to frequent security changes.
- **Do not revoke third-party access** to Search Atlas inside your Google account settings unless you intend to fully disconnect.
- **Avoid switching Google accounts** mid-session when setting up integrations.
- **Grant all requested permissions** during the OAuth flow — skipping optional permissions can cause partial connections that break silently.
- **Monitor the Integrations page** periodically to catch disconnections early before they impact your data or automated features like review auto-responders.

## **🛠️ What Happens When a Token Is Revoked**

When Search Atlas detects a revoked or invalid token (**invalid\_grant** error), the integration is automatically flagged as disconnected and you will see a notification prompting you to reconnect. Features that depend on the affected integration — such as GSC keyword data, GBP review sync, and review auto-responses — will pause until the connection is restored. Reconnecting following the steps above will resume these features without data loss for the period the connection was active.

## **🆘 Still Disconnecting After Reconnecting?**

If your integrations continue to disconnect after following all the steps above, there may be an account-level permission issue or a conflict that requires investigation. If you need further assistance, open the chat widget in the bottom-right corner of the platform and type **human teammate** to be connected with a member of our team.