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

# Troubleshooting Connections

> Fix common issues when connecting platforms to Detrics

Connection issues usually fall into one of three categories: authorization failures, missing accounts, or expired tokens. Here is how to diagnose and fix them.

## Common Issues

### Authorization Fails or Gets Stuck

**Symptoms:** The OAuth popup closes without completing, or you see a generic error after authorizing.

**Solutions:**

* Disable browser pop-up blockers for `app.detrics.io`
* Clear your browser cookies and try again
* Make sure you are authorizing with the correct account (e.g., the Google account that has Google Ads access, not a personal one)
* Try using an incognito/private browser window

### No Accounts Appear After Connecting

**Symptoms:** The connection succeeds but no ad accounts or properties are listed.

**Solutions:**

* Verify that the account you authorized with actually has access to the data. For example, with Meta Ads, you need admin or analyst role on the ad account.
* For Google Ads, make sure your Google account is linked to the MCC or individual ad account.
* Wait a few seconds and refresh, account loading can sometimes take a moment.

### Connection Shows "Expired" or "Disconnected"

**Symptoms:** A previously working connection stops working, or shows a warning badge.

**Solutions:**

* **Reconnect** the platform from the Data Sources page. Click on the platform, find the expired connection, and click the reconnect button.
* If you recently changed your password on the platform, you will need to reauthorize.
* For Meta/Facebook connections, token expiration can happen if Facebook detects unusual activity. Reconnecting resolves this.

### Data Returns Empty or Errors

**Symptoms:** Queries run but return no data or throw errors.

**Solutions:**

* Check that the account you selected actually has data for the time period you are querying
* Verify the connection is still active in **Data Sources**
* For platform-specific API errors, check the troubleshooting guides below

## Platform-Specific Troubleshooting

For detailed troubleshooting guides per platform, see:

<CardGroup cols={2}>
  <Card title="Facebook / Meta Ads" icon="bullhorn" href="/data-source/facebook-ads/troubleshooting">
    OAuth issues, Business Manager access, token expiration
  </Card>

  <Card title="Google Ads" icon="rectangle-ad" href="/data-source/google-ads/troubleshooting">
    MCC access, account linking, API errors
  </Card>

  <Card title="TikTok Ads" icon="video" href="/data-source/tiktok-ads/troubleshooting">
    Business Center access, API limitations
  </Card>

  <Card title="LinkedIn Ads" icon="briefcase" href="/data-source/linkedin-ads/troubleshooting">
    Campaign Manager access, permission issues
  </Card>
</CardGroup>

## Still Need Help?

If you have tried the steps above and the issue persists, reach out to support:

* **Email:** [support@detrics.io](mailto:support@detrics.io)
* **Live chat:** Click the chat bubble in the bottom-right corner of [app.detrics.io](https://app.detrics.io)

Include the platform name, the error message (if any), and the email address you used to authorize.