# Common Issues

## Connection issues

<details>

<summary>OAuth authorization fails or redirects to an error page</summary>

Make sure you're signed in to the correct Trello account before clicking **Connect**. If you manage multiple Trello accounts, Trello may authorize the wrong one. Sign out of all Trello sessions, then reconnect using the account that has access to your target boards.

</details>

<details>

<summary>Connection succeeds but no boards appear in the entity settings</summary>

This usually means the authorized account isn't a member of any boards. Check that the Trello account you connected is added as a member to the boards you want to export. Board visibility alone doesn't grant API access — you must be a board member.

</details>

## Missing data

<details>

<summary>Cards from certain boards are missing from the export</summary>

If you've specified board IDs in the **Board IDs** parameter, only those boards will be exported. Double-check the board IDs by looking at the board URLs in Trello (`trello.com/b/{BOARD_ID}/...`). Leave the field empty to export from all accessible boards.

</details>

<details>

<summary>Actions data is incomplete or only shows recent activity</summary>

The **Actions** entity respects the **Start date** parameter. If you set a recent start date, older actions won't be included. Adjust the start date using the date picker to extend the export window back as far as you need.

</details>

<details>

<summary>Archived cards or lists are missing</summary>

Archived cards and lists are included in exports by default. If you're not seeing them, check whether filters are applied in your destination (e.g., a Google Sheets filter or a BigQuery query with a `WHERE closed = false` clause).

</details>

## Permission errors

<details>

<summary>"Unauthorized" or "403" error after a previously working data flow</summary>

Trello OAuth tokens can expire or be revoked — for example, if you changed your Trello password or revoked app access in your Trello account settings. Go to your data flow's source settings in Coupler.io and reconnect your Trello account.

</details>

<details>

<summary>User emails are not returned in the Users entity</summary>

Trello only returns email addresses for members if your account has organization-level admin permissions. If you're a regular board member, the email field will be empty. Contact your Trello workspace admin for elevated access.

</details>

## Data discrepancies

<details>

<summary>Card counts in the export don't match what I see in Trello</summary>

Trello's board view may hide archived cards by default, while Coupler.io exports them. Filter your exported data on `closed = false` to match what you see on screen. Also check that your Board IDs parameter includes all relevant boards.

</details>

<details>

<summary>Checklist item counts look wrong compared to the card view</summary>

Checklists are exported as a separate entity from Cards. The `checkItems` field in Checklists contains an array — if your destination flattens this array, you may see one row per checklist item rather than one row per checklist. This is expected behavior; aggregate by checklist ID to get totals.

</details>

## Rate limits

<details>

<summary>Data flow fails with a rate limit error</summary>

Trello's API enforces rate limits, especially for large workspaces with many boards and actions. If you hit a rate limit, reduce the scope of your export by specifying only the board IDs you need, or set a more recent start date to limit the Actions volume. Re-run the data flow once the limit resets.

</details>