Obvious/Help Center

Integration Connection Failed

Published February 28, 2026 · Last updated March 5, 2026 · 2 min read

Your integration shows a warning badge, won't connect, or stopped working after it was set up. Here's how to diagnose the issue and get it connected again.

Connection shows "expired" or a warning badge

The integration was working, but now it shows a warning icon in the connectors menu.

What's happening: OAuth tokens have a limited lifespan. If Obvious can't refresh the token (e.g., due to a password change or revoked access), the connection expires.

Fix it:

  1. Open the connectors menu.
  2. Find the integration with the warning badge.
  3. Click the integration name, then Reconnect.
  4. Sign in and authorize access. The connection resumes working.

Connection fails during setup

You click Connect on a new integration but the sign-in window closes without completing, or you see an error after authorizing.

What's happening: OAuth callback errors occur if the authorization flow doesn't complete cleanly. This can be due to browser extensions, pop-up blockers, or a timed-out provider session.

Fix it:

  1. Disable pop-up blockers for Obvious.
  2. Try connecting again in the integrations settings.
  3. Complete the sign-in flow in one go.
  4. If it fails, try a different browser or an incognito/private window.

Integration connects but can't access data

The connection shows as working, but the agent returns errors when trying to read or write data.

What's happening: The integration may lack necessary permissions. Providers often require specific access levels during sign-in; declining or skipping these leaves gaps.

Fix it:

  1. Open the connectors menu and click the integration name.
  2. Click Reconnect.
  3. On the provider's permissions screen, approve all requested access. Obvious requests only what it needs.
  4. After reconnecting, test by asking the agent to perform the action that failed.

Still stuck?

If reconnecting doesn't resolve the issue, check for admin-imposed restrictions on your provider account, then contact Obvious support at help@obvious.ai with the integration name and any error messages.

Next steps

Was this helpful?