Common Issues

Connection issues

API key is not accepted

Double-check that you copied the full API key from Appcues Settings > API without any leading or trailing spaces. API keys are account-scoped, so make sure you're using the key from the correct Appcues account if you manage multiple. If the key was recently regenerated, update it in your Coupler.io data flow settings.

Data flow fails immediately after connecting

This usually means the API key has insufficient permissions or belongs to a user role that doesn't have API access. Verify that your Appcues plan includes API access — some lower-tier plans restrict it. Contact Appcues support to confirm API availability for your account.

Missing data

Some flows or banners are missing from the export

Archived experiences are included by default, but if you applied a start date filter, content created before that date won't appear. Try clearing the start date field to pull all historical records. Also confirm in Appcues that the missing items aren't in a draft state that the API excludes.

Tags or segments export is empty

If you haven't created any tags or segments in Appcues yet, the export will return an empty table — this is expected behavior. Check your Appcues account to confirm that tags or segments exist before troubleshooting further.

Checklist items are missing or incomplete

Checklist item details depend on how the checklist was configured in Appcues. If items appear truncated, it may be because the API returns a summary structure for complex checklists. Try exporting the Checklists entity alongside the Flows entity using Append in case some content overlaps.

Permission errors

"Unauthorized" error when running the data flow

This error means the API key is either invalid or has expired. Regenerate the API key in Appcues and update it in your Coupler.io source settings. If the error persists, confirm with your Appcues account admin that API access is enabled for your account tier.

Data discrepancies

Experience counts don't match what I see in the Appcues dashboard

The Appcues dashboard may apply default filters (e.g., showing only published content) that differ from the unfiltered API export. The Coupler.io export includes all states — published, draft, and archived — unless you filter them yourself. Use the transformation step in Coupler.io to filter by state if you want to match the dashboard view.

Rate limits

Sync fails or returns partial data on large accounts

Appcues enforces API rate limits that can affect large exports. If you're pulling multiple entities in a single data flow run, try splitting them into separate data flows. Scheduling refreshes at off-peak hours can also reduce the chance of hitting rate limits during automated syncs.