Common Issues

Connection issues

I can't connect my Instagram account — I only see Facebook login

This is expected. Instagram Ads uses the Meta (Facebook) Graph API, so you must authenticate with the Facebook account that is linked to your Instagram Business account and has access to your ad accounts. Make sure your Instagram account is connected to a Facebook Business Manager before attempting to connect.

My ad account doesn't appear in the account selector

This usually means the Facebook account you authenticated with doesn't have the right role on that ad account. You need admin or advertiser access in Meta Business Manager. Ask the account owner to grant you access, then reconnect in Coupler.io.

I'm trying to import public Instagram profile data but get an error

Coupler.io's Instagram Ads source only works with paid ad account data — it does not support public profile data or organic post insights. If you need organic Instagram metrics, that requires a separate Instagram Business/Creator account connection, which is a different data source.

Missing data

Some metrics are empty or returning no data

This typically happens because a metric isn't compatible with your campaign objective or ad format. For example, video metrics only appear when your ads include video. Some older metrics were also deprecated by Meta — if a field used to work and now returns nothing, check whether Meta has retired it from the API.

My Insights report shows no data for a specific date range

Check that your ad campaigns were actually running during the selected period. Also confirm that the start date and end date are set correctly using the date pickers — an inverted date range (end before start) will return nothing. If campaigns ran but data is still missing, try narrowing the date range to isolate the issue.

Monthly stats aren't showing correctly

If you're expecting monthly-aggregated data, make sure you've set Split data by period to Monthly in the report settings. By default, the report uses a daily breakdown, which can look misleading if you're expecting one row per month. Also ensure your date range spans at least one full calendar month.

Permission errors

I get a permissions error when running the data flow

This usually means the Facebook account used to connect doesn't have sufficient access to the ad account, or that the required API permissions were not granted during OAuth. Try reconnecting the source in Coupler.io and make sure you accept all permission requests during the Facebook login flow. If the issue persists, verify your role in Meta Business Manager.

Data discrepancies

The numbers in Coupler.io don't match what I see in Meta Ads Manager

A few things can cause this:

• Attribution windows: If your Coupler.io report uses a different attribution window than what's set as default in Meta Ads Manager, numbers will differ. Align attribution settings between both.

• Time zone: Meta reports metrics based on the ad account's time zone. If your date range crosses midnight in a different time zone, day-level totals may not match.

• Data delays: Meta's API can have a delay of up to 48–72 hours for finalized conversion data. Very recent data may still be in flux.

Rate limits

My data flow fails with a rate limit error

Meta's Graph API enforces rate limits per ad account. If you're pulling large date ranges, many breakdowns, or running multiple data flows against the same account simultaneously, you may hit these limits. Try reducing the date range, simplifying breakdowns, or spacing out your data flow runs.