The OAuth Credential Health Status panel in Search Atlas shows whether each connected provider (Google, Facebook, LinkedIn, TikTok, Twitter) is active, invalid, or expired so you can fix broken connections before they interrupt your data.
📋 What OAuth Credential Health Status Shows
The OAuth Credential Health Status panel lives in your Search Atlas dashboard and reports the live connection state for each OAuth provider you've linked to your workspace.
Each connected provider shows one of three statuses:
- Active — The credential is valid and Search Atlas can pull data from the provider.
- Invalid — The credential exists but the provider rejected it (for example, permissions were revoked or the account was disconnected on the provider's side).
- Expired — The credential's token is no longer accepted because its lifetime has elapsed and it needs to be refreshed.
Supported OAuth providers in Search Atlas:
- Google (Google Search Console, Google Analytics, Google Business Profile)
- TikTok
A clear status label appears next to each provider so you know exactly which connections need attention.
🟢 What an Active Status Means
An Active status confirms that Search Atlas is successfully authenticated with the provider and can continue pulling reports, metrics, and audience data.
No action is needed when a provider shows Active. Your dashboards, rank tracking, and reports will update on their normal schedule.
⚠️ What an Invalid Status Means and How to Fix It
An Invalid status means the provider rejected your stored credential. Common causes include:
- You revoked Search Atlas access from the provider's security settings.
- The connected account's password was changed or the account was deleted.
- Required permissions or scopes were removed.
- Two-factor authentication was added and the original consent is no longer valid.
Reconnect an Invalid provider
- Go to Settings → Integrations in your Search Atlas dashboard.
- Locate the provider showing the Invalid status.
- Click Reconnect.
- Sign in to the provider and approve all requested permissions.
- Return to Search Atlas — the status will update to Active once the new credential is accepted.
Your data sync will resume on the next scheduled refresh.
⏰ What an Expired Status Means and How to Fix It
An Expired status means the OAuth token issued by the provider has reached the end of its lifetime and can no longer be refreshed automatically. This is normal — providers expire tokens on a fixed schedule for security.
Refresh an Expired provider
- Open Settings → Integrations in your Search Atlas dashboard.
- Find the provider marked Expired.
- Click Reconnect to re-authenticate.
- Sign in to the provider and grant the requested permissions.
- Confirm the status changes to Active.
Once reconnected, Search Atlas will resume collecting data from that provider.
🛠️ Troubleshooting Reconnection Issues
If a provider still shows Invalid or Expired after you reconnect, try these steps:
- Use the correct account — Sign in with the same provider account that owns the data you want to sync.
- Approve all permissions — If the provider's consent screen lists optional scopes, accept all requested permissions so Search Atlas can read the data it needs.
- Clear browser sessions — Sign out of the provider in your browser, then start the reconnection again to avoid using a stale session.
- Check provider-side access — Confirm Search Atlas still appears in your provider's connected apps list and hasn't been removed by an admin.
If the status remains incorrect after reconnecting, contact Search Atlas support with the provider name and the time you attempted to reconnect.
🎯 You now know how to read OAuth Credential Health Status in Search Atlas and how to bring any Invalid or Expired provider back to Active. Visit Settings → Integrations whenever a status changes to keep your data flowing without interruption.