# Common Issues

## Connection issues

<details>

<summary>"Invalid credential" error when connecting Trello</summary>

This usually means the OAuth token has expired or was revoked. Disconnect your Trello account from Coupler.io and reconnect it by going through the OAuth flow again. Make sure you're logged in to the correct Trello account in your browser before reconnecting.

</details>

<details>

<summary>Connected to the wrong Trello account</summary>

Coupler.io connects to whichever Trello account is currently active in your browser. If you have multiple Trello accounts, log out of Trello first, then sign in to the correct account before authorizing Coupler.io.

</details>

## Missing data

<details>

<summary>Custom fields are missing from the export</summary>

Trello Custom Fields (from the Custom Fields Power-Up) aren't always included in the default export. First, run an export without any column filters to get all available fields. Then identify the exact column names for your custom fields and enter them in the **Columns** parameter to include them going forward.

{% hint style="warning" %}
Custom Fields from third-party Power-Ups (other than Trello's own Custom Fields Power-Up) may not be accessible via the Trello API at all.
{% endhint %}

</details>

<details>

<summary>Some columns aren't appearing in the output</summary>

If you've specified column names in the **Columns** field, double-check the spelling — column names are case-sensitive. The safest approach is to run a full export first (leave Columns empty), copy the exact column names from the output, and paste them back into the Columns field.

</details>

<details>

<summary>Cards from a specific list are missing</summary>

Coupler.io exports all cards from the entire board, not individual lists. If certain cards are missing, check whether they've been archived in Trello — archived cards have `closed: true` and may need to be filtered in your destination. Also confirm you've entered the correct board URL.

</details>

<details>

<summary>Checklist items aren't showing up</summary>

Checklist items are a separate entity from Board cards. Make sure you've selected **Checklist items** as the entity in your data flow — they won't appear in a Board cards export.

</details>

## Permission errors

<details>

<summary>"Board id was not found" error</summary>

This error means the board URL you entered is incorrect, the board has been deleted, or the connected Trello account doesn't have access to that board. Verify the board URL by opening the board in Trello and copying the URL directly from the browser. Also confirm the authorized account is a member of that board.

</details>

<details>

<summary>Can't access a private board</summary>

Private Trello boards require the connected account to be a member. Ask the board owner to add your Trello account, then retry the data flow.

</details>

## Data discrepancies

<details>

<summary>Card count in Coupler.io doesn't match what I see in Trello</summary>

Trello's board view hides archived cards by default, but the API includes them. This is the most common reason for a higher card count in your export. Filter rows where `closed = true` in your destination to match what you see in Trello.

</details>

<details>

<summary>Labels appear as a long string instead of separate values</summary>

Trello returns labels as an array object. In spreadsheet destinations, this may render as a JSON-formatted string. You can parse this in Google Sheets using a formula, or use Coupler.io's column selection to pull specific label subfields if available.

</details>

## Rate limits

<details>

<summary>Exports are slow or timing out for very large boards</summary>

Trello's API applies rate limits that can slow down exports from boards with thousands of cards or a long activity history. If you're hitting this, try using the **Start date** parameter to limit the data range, or split large boards into separate data flows by entity type.

</details>