> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/trello.md).

# Trello

Integration with Trello for managing boards, lists, and cards: list boards, read a board's lists, create lists and cards, read, update, and delete cards, and comment on cards.

## Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector | Authentication   |
| --------- | ---------------- |
| Trello    | API key or token |

### Trello

Connect to Trello with an API key and token to manage boards, lists, and cards.

#### Set up in Trello

1. Prepare the Trello account or service that the workflow will access. Grant access to the required resources and operations.
2. **API Key:** Your Trello API key. Create a Power-Up at <https://trello.com/power-ups/admin>, open its API Key tab, and generate a key.
3. **API Token:** A Trello token authorizing this key for your account. Generate one from the API Key tab (the 'Token' link) and grant the boards you want to automate.

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **Trello**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field | Required | What to enter                                                                                                                                                                          |
| ------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Key       | Yes      | Your Trello API key. Create a Power-Up at <https://trello.com/power-ups/admin>, open its API Key tab, and generate a key. [Provider instructions](https://trello.com/power-ups/admin). |
| API Token     | Yes      | A Trello token authorizing this key for your account. Generate one from the API Key tab (the 'Token' link) and grant the boards you want to automate.                                  |

### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

## Use an action

1. Add the required **Trello** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

### List boards

See the Trello boards your connected account can access.

#### Inputs

| Field        | Type            | Required | Description                                                                                                          |
| ------------ | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
| Board filter | select (string) | No       | Which boards to include: open, closed, starred, or all. Available values: Open, Closed, Starred, All. Default: open. |

#### Outputs

| Field  | Type          | Description                                  |
| ------ | ------------- | -------------------------------------------- |
| Boards | object\_array | The boards the connected account can access. |

### Get board lists

See the lists (columns) on a Trello board.

#### Inputs

| Field       | Type            | Required | Description                                                                                                  |
| ----------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------ |
| Board       | select (string) | Yes      | The board whose lists you want to read. Options load from the selected connection.                           |
| List filter | select (string) | No       | Which lists to include: open, closed (archived), or all. Available values: Open, Closed, All. Default: open. |

#### Outputs

| Field | Type          | Description                             |
| ----- | ------------- | --------------------------------------- |
| Lists | object\_array | The lists on the board, in board order. |

### Create list

Add a new list (column) to a Trello board.

#### Inputs

| Field     | Type            | Required | Description                                                                  |
| --------- | --------------- | -------- | ---------------------------------------------------------------------------- |
| Board     | select (string) | Yes      | The board to add the new list to. Options load from the selected connection. |
| List name | string          | Yes      | The name of the new list.                                                    |
| Position  | string          | No       | Where to place the list: 'top', 'bottom', or a number.                       |

#### Outputs

| Field     | Type   | Description                               |
| --------- | ------ | ----------------------------------------- |
| List ID   | string | The new list's id.                        |
| List name | string | The new list's name.                      |
| Board ID  | string | The board the list belongs to.            |
| Position  | number | The list's numeric position on the board. |

### Create card

Create a card in a Trello list, with an optional description, due date, members, and labels.

#### Inputs

| Field        | Type            | Required | Description                                                                                                                  |
| ------------ | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Board        | select (string) | No       | Pick a board to filter the list dropdown. The card goes into the list you choose. Options load from the selected connection. |
| List         | select (string) | Yes      | The list (column) the new card is created in. Options load from the selected connection.                                     |
| Card name    | string          | Yes      | The title of the new card.                                                                                                   |
| Description  | string          | No       | The card's description (supports Markdown).                                                                                  |
| Due date     | datetime        | No       | An optional due date and time for the card.                                                                                  |
| Due complete | boolean         | No       | Mark the due date as already completed.                                                                                      |
| Member IDs   | string          | No       | Comma-separated Trello member ids to assign to the card.                                                                     |
| Label IDs    | string          | No       | Comma-separated Trello label ids to add to the card.                                                                         |

#### Outputs

| Field | Type   | Description       |
| ----- | ------ | ----------------- |
| Card  | object | The created card. |

### Get card

Read the details of a Trello card by its id.

#### Inputs

| Field   | Type   | Required | Description                                 |
| ------- | ------ | -------- | ------------------------------------------- |
| Card ID | string | Yes      | The id (or short link) of the card to read. |

#### Outputs

| Field | Type   | Description         |
| ----- | ------ | ------------------- |
| Card  | object | The requested card. |

### Update card

Rename, re-describe, move, archive, or reschedule a Trello card.

#### Inputs

| Field        | Type     | Required | Description                                                      |
| ------------ | -------- | -------- | ---------------------------------------------------------------- |
| Card ID      | string   | Yes      | The id of the card to update.                                    |
| Card name    | string   | No       | A new title for the card. Leave blank to keep the current title. |
| Description  | string   | No       | A new description. Send an empty value to clear it.              |
| Move to list | string   | No       | Move the card to a different list by its id.                     |
| Archived     | boolean  | No       | Archive the card (true) or restore it (false).                   |
| Due date     | datetime | No       | A new due date and time.                                         |
| Due complete | boolean  | No       | Mark the due date complete (true) or incomplete (false).         |
| Position     | string   | No       | Reorder the card: 'top', 'bottom', or a number.                  |

#### Outputs

| Field | Type   | Description       |
| ----- | ------ | ----------------- |
| Card  | object | The updated card. |

### Delete card

Permanently delete a Trello card. This cannot be undone.

#### Inputs

| Field   | Type   | Required | Description                               |
| ------- | ------ | -------- | ----------------------------------------- |
| Card ID | string | Yes      | The id of the card to permanently delete. |

#### Outputs

| Field   | Type    | Description                   |
| ------- | ------- | ----------------------------- |
| Deleted | boolean | Whether the card was deleted. |
| Card ID | string  | The id of the deleted card.   |

### Add comment

Post a comment on a Trello card.

#### Inputs

| Field   | Type   | Required | Description                                   |
| ------- | ------ | -------- | --------------------------------------------- |
| Card ID | string | Yes      | The id of the card to comment on.             |
| Comment | string | Yes      | The comment text to post (supports Markdown). |

#### Outputs

| Field      | Type   | Description                             |
| ---------- | ------ | --------------------------------------- |
| Comment ID | string | The id of the created comment action.   |
| Comment    | string | The comment text that was posted.       |
| Date       | string | When the comment was posted (ISO 8601). |
| Card ID    | string | The card the comment was added to.      |

## Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/trello.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
