# Common Issues

## Connection issues

<details>

<summary>My API token is not accepted</summary>

Double-check that you're using the correct API token from Adjust. Go to **Account Settings → Your profile → API token** in Adjust — this is different from your app token. Make sure there are no leading or trailing spaces when you paste it into Coupler.io.

</details>

<details>

<summary>The data flow fails immediately after setup</summary>

This usually means no metrics were selected. Adjust requires at least one metric to generate a report. Go back to the **Metrics and dimensions** step in your data flow settings and confirm at least one metric is selected.

</details>

## Missing data

<details>

<summary>My report returns no rows</summary>

Check the following:

* At least one metric must be selected — the API won't return data without it
* Your start date may be set too recently or in the future — use the date picker to set a date that falls within a period with known activity
* If you're filtering by specific dimensions, make sure those dimensions have associated data for the date range you've selected

</details>

<details>

<summary>Some campaigns or networks are missing from my report</summary>

Adjust only returns data for sources active in the selected date range. If a campaign ran before your start date, it won't appear. Also confirm that the relevant networks are connected and properly tracked in your Adjust account.

</details>

<details>

<summary>Cohort metrics are empty or lower than expected</summary>

Cohort metrics require sufficient time to accumulate. If you're pulling `cohort_revenue` for installs that happened recently, there may not be enough post-install activity recorded yet. Try extending the date range to give cohorts more time to mature.

</details>

## Permission errors

<details>

<summary>I get a 401 or "unauthorized" error</summary>

Your API token may have been regenerated or expired. Log into Adjust, navigate to your profile settings, and check if the token shown matches what you have in Coupler.io. If it differs, update the token in your data flow's source settings.

</details>

<details>

<summary>I can connect but can't see data for certain apps</summary>

The API token is tied to your Adjust user account. If your account doesn't have access to specific apps in Adjust, those apps won't appear in your report. Contact your Adjust account admin to request the necessary permissions.

</details>

## Data discrepancies

<details>

<summary>Adjust numbers don't match what I see in ad network dashboards</summary>

This is expected. Adjust attributes installs based on its own attribution logic (last-click, probabilistic, etc.), while networks report all clicks and installs they claim credit for. Use `network_installs_diff` and `network_cost_diff` metrics to see the delta explicitly.

</details>

<details>

<summary>Revenue figures differ from my internal records</summary>

Adjust revenue tracks what's reported through its SDK events. If some purchases aren't firing the revenue event correctly, or if refunds aren't being reported, totals will differ. Also check if you're comparing `revenue` (IAP only) vs. `all_revenue` (IAP + ad revenue) — using the wrong metric is a common source of confusion.

</details>

## Rate limits

<details>

<summary>My data flow errors out with a rate limit message</summary>

Adjust's reporting API has rate limits that vary by plan. If you're running large reports with many dimensions and a long date range, try narrowing the date window or reducing the number of dimensions. Avoid running multiple data flows against Adjust simultaneously.

</details>
