Common Issues

Connection issues

OAuth authorization fails or "Invalid credentials" error

Pinterest's OAuth session may have expired or your Pinterest account permissions may have changed.

Fix:

1. Disconnect the Pinterest Ads source from Coupler.io (go to Data sources, click the source, and select Disconnect).

2. Delete any existing data flows using Pinterest Ads.

3. Reconnect by creating a new data flow and signing in to your Pinterest Business account again.

4. Verify that your Pinterest account has Ads Manager or Admin access.

5. Ensure your ad account is not restricted or in violation of Pinterest's policies.

"Permission denied" when selecting ad accounts

Your Pinterest user account may not have access to the ad accounts you're trying to select, or your account role is too restricted.

Fix:

1. Log into your Pinterest Business account and go to Ads Manager → Settings → Business Access.

2. Verify that your user account has at least Analyst role (can view reports) on the ad accounts you want to pull data from.

3. If you just added a new ad account, wait 15–30 minutes for permissions to sync, then reconnect in Coupler.io.

4. Contact your Business Account Manager if you're still seeing restricted accounts.

"No data available" for selected ad account

The ad account may not have any campaigns, ads, or conversions during your selected date range.

Fix:

1. Verify the ad account is active and has running campaigns during your start/end date range.

2. Check the Pinterest Ads Manager directly to confirm data exists for the same date range.

3. If the account is brand new, campaigns may still be pending approval. Wait 24 hours and try again.

4. Try expanding your date range (e.g., from last 7 days to last 30 days) to ensure data exists.

Missing data

Conversion metrics are zero or very low compared to Pinterest Ads Manager

Conversion data depends on your conversion window and conversion report time settings. If these don't match your Pinterest Ads Manager setup, reported conversions will differ.

Fix:

1. In your data flow, check the Conversion window setting. The default is 30/1/1 (30 days post-click, 1 day post-engagement, 1 day post-view). If your Ads Manager uses a different window (e.g., 7/7/1), change it to match.

2. Verify Conversion report time is set to the same option as in Ads Manager: either "Time of ad action" (default) or "Time of conversion".

3. Ensure you've selected the correct conversion type metrics (Web conversions, In-app conversions, etc.). If you're only pulling "Web conversions (Checkout)" but your traffic includes sign-ups, you'll miss those conversions.

4. Check that your selected date range includes the conversion window. For example, if you set "Time of conversion" and pull data for today with a 30-day conversion window, conversions from clicks 30 days ago appear today, but clicks from today won't convert for 30 days.

Some campaigns or ads are missing from the report

Campaigns or ads may be filtered out if they don't match the metrics or date range criteria.

Fix:

1. Verify that campaigns have metrics data during your selected date range. Paused campaigns with no impressions may not appear in performance reports.

2. Use a List report (e.g., "List of campaigns" or "List of ads") to see all campaigns/ads in your account regardless of performance.

3. Check if you've applied additional filters that may be excluding certain campaigns (e.g., filtering by minimum spend or impression thresholds).

4. Try expanding your date range to the last 90 days to confirm campaigns exist.

Engagement metrics (saves, outbound clicks) are missing or zero

Engagement metrics are only available for certain report types and content formats. Not all pins generate all engagement types.

Fix:

1. Confirm you've selected an engagement metric (Paid engagements, Saves, Outbound clicks, Pin clicks, etc.) in the Metrics parameter.

2. Check that your pins are not video-only (video pins may not generate all engagement types equally).

3. Use a different engagement metric (e.g., swap "Paid saves" for "Paid engagements") to see if data exists.

4. Verify pins are getting impressions. If a pin has 0 impressions, it will have 0 engagement.

Permission errors

"Insufficient permissions" or "Access denied" error

Your Pinterest Ads Manager account role is too restricted, or you're trying to access an ad account you don't own.

Fix:

1. Contact the Business Account Owner or Admin and request at least Analyst or Editor role on the ad account.

2. Ask them to verify your user is added to Business Access in Ads Manager Settings.

3. If you manage client accounts via a brand partner program, ensure your brand account has been granted access to each client's ad account.

4. If you're a fresh team member, wait 15–30 minutes for role changes to propagate in Pinterest's system.

Data discrepancies

Spend or metrics differ between Coupler.io and Pinterest Ads Manager

Data mismatches usually stem from conversion window settings, timezone differences, or reporting time misalignment.

Fix:

1. Match conversion windows: Open Pinterest Ads Manager, go to Settings, and check your default conversion window. Set the same window in Coupler.io (Conversion window parameter).

2. Check conversion report time: In Coupler.io, select "Time of ad action" (default) and verify this matches your Ads Manager setting.

3. Verify date range: Ensure your Coupler.io start/end dates match the report date range in Ads Manager. Note that data may shift if you change the conversion window.

4. Check timezone: Pinterest reports in your account's timezone. Verify Coupler.io's destination (e.g., Google Sheets) is not applying a different timezone.

5. Wait for data finalization: Pinterest's data can shift slightly within 24–48 hours as conversions are attributed. Compare reports from the same time yesterday for consistency.

6. Pull raw data: If using aggregated metrics (e.g., "Split data by month"), try pulling "Totals only" to see raw metrics without aggregation, then aggregate yourself.

Spend is accurate but conversions are significantly off

Conversion attribution settings (click, engagement, view window) or conversion type selection is likely the cause.

Fix:

1. In Coupler.io, check you've selected all relevant conversion types (Web, In-app, Offline, Custom). Don't just select one.

2. Verify your conversion window matches Pinterest's attribution model. A 30/30/30 window will report more conversions than a 7/1/1 window.

3. Check that "Time of conversion" is not selected if your Ads Manager uses "Time of ad action"—switching between these reporting times can shift which conversions appear.

4. In Pinterest Ads Manager, manually check a campaign's conversion metrics for the same date range. Note the exact numbers and match Coupler.io settings.

5. If mismatch persists, try pulling a List report (campaigns or ads) alongside a performance report to cross-reference which campaigns are included.

Data refreshed but numbers changed retroactively (yesterday's spend changed)

Pinterest recalculates conversions and engagement metrics as data arrives. This is normal, especially for view-through conversions and attribution windows.

Fix:

1. This is expected behavior—conversion data can shift within 24–48 hours as Pinterest's servers finalize attribution.

2. Use the "Time of conversion" report time setting if you need stable historical data, as it reports when the conversion actually occurred, not when Pinterest measured it.

3. If you're monitoring daily performance, compare the same day from 2+ days ago (e.g., today vs. two days ago) for stable numbers.

4. For financial reporting, pull data 2–3 days after the period ends to allow Pinterest time to finalize attribution.

Rate limits

Data flow runs slowly or times out, especially with large date ranges or many metrics

Pinterest's API has rate limits. Large pulls (30+ metrics, 90+ day range, multiple ad accounts) may hit these limits.

Fix:

1. Reduce metrics: Select only the metrics you actually need. Each metric is a separate API call; 50 metrics = 50 calls. Aim for 10–20 metrics per flow.

2. Shorten the date range: Instead of pulling 90 days at once, pull the last 30 days and schedule daily refreshes. Coupler.io will keep a rolling window of recent data.

3. Split by ad account: If you have 5+ ad accounts, create separate data flows for each account, then use Append to combine in a final flow.

4. Increase refresh interval: If you're refreshing every hour, scale back to every 6 hours or daily. More frequent refreshes = more API calls.

5. Use "Totals only": Avoid splitting data by period (daily/weekly/monthly) on large reports. Pull totals and aggregate in your destination (e.g., Google Sheets pivot table) if needed.

"API quota exceeded" or "Too many requests" error during scheduled refresh

Your data flow is running at the same time as another job (e.g., another Coupler.io integration), or you have multiple flows pulling Pinterest data simultaneously.

Fix:

1. Stagger your data flow refresh times. If you have 3 Pinterest flows, schedule them 10 minutes apart instead of all at once.

2. Check if other team members are also running Pinterest data flows. Coordinate to avoid simultaneous pulls.

3. Temporarily pause non-critical data flows during peak hours.

4. Contact Coupler.io support if this persists; we can help optimize your flow architecture.