Common Issues

Connection issues

OAuth authorization fails or I'm redirected back with an error

Make sure you're signing in with the correct Asana account — the one that has access to the workspace you want to export. Try disconnecting the existing connection in Coupler.io, revoking Coupler.io's access in your Asana account settings, and reconnecting from scratch.

Coupler.io doesn't show my Asana Business account or workspace

If your workspace isn't appearing, check that your Asana account role allows Portfolio or workspace access. For Portfolios specifically, confirm you have create/edit permissions in Asana. If the issue persists, try re-authorizing your connection — sometimes a fresh OAuth handshake resolves visibility problems.

Missing data

Custom fields are missing or show as a long JSON string

Asana returns custom fields as a JSON-formatted column rather than individual columns. The data is there — it's just nested. Use Coupler.io's calculated column feature with the json_extract function to pull specific custom field values into their own columns.

Some columns are empty (e.g., completed_by.name)

Certain fields like completed_by.name are only populated when a task is marked complete by a specific user — they'll be empty for tasks completed via automation or bulk actions. This is a limitation of the data Asana's API returns, not a Coupler.io issue.

I can't filter tasks by a specific project

Filtering Tasks by a specific project GID is not currently supported as a source parameter. As a workaround, export all Tasks and use Coupler.io's filter transformation — or filter in your destination (e.g., Google Sheets filter views or BigQuery WHERE clauses) using the projects column.

Subtasks are not appearing in my Tasks export

Subtasks are included in the Tasks entity but are identified by a non-null parent field. If you're not seeing them, check whether you're filtering out rows with a parent value. There is no separate subtasks entity.

Permission errors

"Data cannot be fetched" error when running the data flow

This error most commonly occurs when your Asana account is using a personal project space instead of an organization workspace. Asana's API does not support personal spaces. You'll need to migrate your projects to an organization workspace to use Coupler.io. Contact Asana support for help with migration.

This is the most common error reported for Asana. Personal project spaces are not compatible with Asana's API — there is no workaround other than migrating to an organization workspace.

Portfolios entity returns no data

Portfolios are only available on Asana Business and Enterprise plans. If you're on a Free or Premium plan, this entity will return empty results. Also verify that you have permission to view portfolios in your workspace.

Data discrepancies

Task count in Coupler.io doesn't match what I see in Asana

Coupler.io fetches tasks across all workspaces your account has access to. If you're seeing more tasks than expected, you may be pulling from multiple workspaces. Use the Changed after date filter to scope your export, and filter by the projects column to narrow results after import.

Rate limits

Data flow times out or fails on large workspaces

Asana's API can slow down when responding to requests for very large workspaces (hundreds of projects, thousands of tasks). If your data flow consistently times out, use the Changed after date filter to export only recently modified records. Running incremental exports rather than full refreshes significantly reduces API response time.