Common Issues

Connection issues

OAuth authorization fails or loops back to the login screen

Make sure you're logged into the correct X account in your browser before starting the OAuth flow. If you manage multiple X accounts, log out of any personal accounts and log in with the account that has X Ads access. Then retry the connection in Coupler.io.

Connected successfully but no ad accounts appear

The X account you authorized must have access to at least one ad account. Check in X Ads Manager (ads.twitter.com) that your account is listed as an account user with at least read permissions. If you were recently added to an account, try disconnecting and reconnecting the source.

Missing data

No data returned from the source

First, confirm your date range overlaps with a period when the selected ad account had active campaigns. Check that your chosen entity (e.g., Promoted tweet) actually has data for that account — some entities may be empty if that campaign type was never used. Also verify that at least one metric group is selected.

Campaign name or tweet name is missing from the report

Name fields like campaign name or tweet name come from entity-level reports (Campaign, Promoted tweet), not from analytics reports. If you're pulling metrics only and don't see names, add a second source with the same entity set to pull metadata, then use Coupler.io's Join transformation to merge them on the campaign or tweet ID.

Add-to-cart or purchase conversions show as zero or are missing

Conversion metrics depend on your X Pixel and conversion tags being correctly set up in X Ads Manager. If the tags aren't firing, no conversion data will appear. Verify your tags are active under Tools > Conversion Tracking in X Ads Manager before pulling conversion metric groups.

Permission errors

"Insufficient permissions" error when running the data flow

The X account used for OAuth needs at least read access to the ad account. Campaign managers with restricted roles may not have API-level read access. Ask your X Ads account admin to verify your permission level under account user settings.

Data discrepancies

Metrics in Coupler.io don't match X Ads Manager

Check that your date range and granularity settings match what you're viewing in X Ads Manager. X Ads Manager uses your account's timezone — make sure your data flow date range accounts for this. Also confirm you're comparing the same placement type; selecting "All" returns a row per placement, which can cause totals to look inflated if you sum them.

Rate limits

Data flow fails with a rate limit or API quota error

X Ads API has rate limits that vary by account tier. If you're pulling large date ranges with hourly granularity and multiple segmentation dimensions simultaneously, you may hit these limits. Try reducing the date range, switching to daily granularity, or splitting your report into separate data flows for different entities.