# Trello

SureCloud connects to Trello to retrieve board, list, and card data from your Trello workspace. This allows SureCloud to monitor the progress of compliance tasks and audit action items managed on Trello boards — confirming that cards are moving through defined workflow stages and that ownership and due dates are being maintained.

## Authentication and setup

Trello authenticates API requests using an API Key and Token pair. SureCloud uses a dedicated token generated by a Trello member with access to the relevant boards.

{% stepper %}
{% step %}
**Retrieve your Trello API Key**

Log in to Trello and navigate to <https://trello.com/power-ups/admin>. Click **New** to create a new Power-Up, or navigate to **<https://trello.com/app-key>** to view your personal API key. Copy the **API Key**.
{% endstep %}

{% step %}
**Generate a Token**

From the API key page, click **Generate a Token** next to the API key. Trello will ask you to authorise the token — name it `SureCloud CCM` and set the expiration to **Never** (or 30/60 days and rotate accordingly). Click **Allow**. Copy the generated token.
{% endstep %}

{% step %}
**Enter the credentials in SureCloud**

Navigate to **SureCloud → Integrations → Trello → Connect**. Enter the **API Key** and the **Token**. Click **Save** and then **Test Connection**.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
The Trello API token provides access to all boards visible to the generating user. Store it securely. SureCloud encrypts it at rest, but treat it as a sensitive credential. If the token was generated with an expiry, rotate it before it expires and update it in **SureCloud → Integrations → Trello → Edit Connection**.
{% endhint %}

## Endpoints

| API Call                            | Use Case                                                              |
| ----------------------------------- | --------------------------------------------------------------------- |
| `GET /1/members/me`                 | Verify token and retrieve authenticated member details                |
| `GET /1/members/me/boards`          | Enumerate all boards accessible to the token owner                    |
| `GET /1/boards/{id}/lists`          | Retrieve lists (workflow stages) on a compliance board                |
| `GET /1/boards/{id}/cards`          | Retrieve all cards on a board including status, due date, and members |
| `GET /1/cards/{id}`                 | Retrieve individual card detail including checklists and labels       |
| `GET /1/boards/{id}/members`        | Enumerate members with access to a specific board                     |
| `GET /1/organizations/{id}/members` | Enumerate workspace members and roles at the organisation level       |

## Pagination

`GET /1/boards/{id}/cards` supports pagination using `before` and `limit` parameters. SureCloud retrieves cards in batches of up to 1,000 (Trello's maximum per request) and uses the last card ID from each batch as the `before` parameter in the next request.

```json
GET /1/boards/{id}/cards?limit=1000&before=<last_card_id_from_previous_response>
```

`GET /1/members/me/boards` returns all accessible boards in a single response. Most Trello API calls for well-scoped boards return complete data in a single request.

## Required permissions

The Trello token requires **read** access to all boards the connecting user is a member of. No write, admin, or Power-Up management permissions are required. Ensure the token-generating account is a member of the compliance and audit boards SureCloud needs to monitor.

## Polling frequency

| Data Type                          | Interval       |
| ---------------------------------- | -------------- |
| Cards and their status/due dates   | Every 6 hours  |
| Board lists and workflow structure | Every 24 hours |
| Board membership                   | Every 24 hours |

## Troubleshooting

<details>

<summary>Connection test returns 401 Unauthorized</summary>

The API Key or Token is incorrect or the token has expired. Regenerate the token at <https://trello.com/app-key> and update it in **SureCloud → Integrations → Trello → Edit Connection**. If the token was generated with a 30 or 60-day expiry, create a new one set to **Never** expire or establish a rotation schedule.

</details>

<details>

<summary>Some boards are not visible in SureCloud</summary>

SureCloud only sees boards accessible to the account that generated the token. Private boards the account is not a member of will not appear. Add the account to the relevant boards in Trello and trigger a manual refresh in SureCloud.

</details>

<details>

<summary>Cards appear in Trello but are missing from SureCloud</summary>

Archived cards are not returned by the default cards endpoint. SureCloud collects active (non-archived) cards. If you need to evidence completed work that was archived in Trello, retrieve it directly from the Trello console as archived card data is not included in SureCloud's collection.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://surecloud.gitbook.io/surecloud-docs/integrations/ccm-and-evidence-collection-integrations/trello.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.