# Trello

Create, move and update Trello cards, comment on them, manage checklists, labels, attachments and custom fields, and work with lists, boards and board members.

## Connect Trello

1. In the sidebar, open **Connections** and press **Add connection**.
2. Type `trello` and choose **Trello**.
3. Fill in the fields. Each one says **Required** or **Optional**.
4. Press **Test and save**. GoRunner checks the connection before it saves anything.

The sheet asks for:

- **API key · Required**: The API key of your Trello Power-Up (32 characters).
- **Token · Required**: A token made for that key (the Token link beside it). A token made with an expiration (1 hour, 1 day, 30 days) stops working then; make a new one and update the connection.
- **API secret · Optional**: Optional; steps do not use it. The Power-Up’s secret, which Trello signs each webhook delivery with.

Paste a Trello API key and a token made for it. At trello.com/apps/admin create a Power-Up (or open yours), generate an API key in its Trello Auth tab, then follow the Token link beside the key and allow access. The token acts as you: steps see the boards you can see.

[Connections](https://docs.gorunner.io/build/connections) says how to sign in again, rename or delete it. In a product that embeds GoRunner, **Add connection** can be missing: then [your provider makes connections](https://docs.gorunner.io/embed/customer-connections) for you.

## Start a workflow

Add a trigger and choose **Trello**. The trigger uses the same connection as the steps.

### On Trello Activity

Starts a run each time Trello reports activity on the board, list or card below (on a board, that includes its lists and cards). Publishing the workflow registers a Trello webhook pointed at it, replacing any left from before; unpublishing removes it. Trello signs every delivery with your Power-Up's API secret, so the connection needs it (API secret); a delivery without a valid signature is refused. Trello repeats a delivery that was not answered; the repeat starts no second run. Trello removes the webhook when the connection's token is revoked or expires.

- **Board, List or Card · Required**: What to watch: pick a board, or paste a board, list or card id, or a board or card link.
- **Only These Activities · Optional**: Start a run only for these kinds of activity. Leave empty to start one for every activity. Options: Card created to Power-Up disabled (43 options).

A later step can use its data, such as `{{trigger.action}}`, `{{trigger.model}}`, `{{trigger.trello}}`. See [Use data from earlier steps](https://docs.gorunner.io/build/use-data-from-earlier-steps).

## Do things in Trello

Add a **Trello** step, choose a **Resource**, then an **Operation**. Choose a row to see its fields.

- [Card](https://docs.gorunner.io/apps/trello#fields-f-card): Create · Get · Get Many on a Board · Search · Update · Move · Archive · Unarchive · Add Member · Remove Member · Set Custom Field · Delete
- [Card Comment](https://docs.gorunner.io/apps/trello#fields-f-cardcomment): Create · Get Many · Update · Delete
- [Checklist](https://docs.gorunner.io/apps/trello#fields-f-checklist): Create · Get · Get Many · Delete · Create Checklist Item · Get Checklist Item · Update Checklist Item · Delete Checklist Item · Get Completed Checklist Items
- [Label](https://docs.gorunner.io/apps/trello#fields-f-label): Create · Get · Get Many · Update · Delete · Add to Card · Remove from Card
- [Attachment](https://docs.gorunner.io/apps/trello#fields-f-attachment): Create · Get · Get Many · Download · Delete
- [List](https://docs.gorunner.io/apps/trello#fields-f-list): Create · Get · Get Many · Get Cards · Update · Archive · Unarchive
- [Board](https://docs.gorunner.io/apps/trello#fields-f-board): Create · Get · Get Many · Update · Delete
- [Board Member](https://docs.gorunner.io/apps/trello#fields-f-boardmember): Add · Get Many · Invite · Remove

Later steps read a step’s output by its name: see [Use data from earlier steps](https://docs.gorunner.io/build/use-data-from-earlier-steps).

## Limits

- A reply from Trello can be up to 16 MB (a file download can have its own limit). A larger one fails the step; it is never cut short.
- When Trello says to slow down (429), the step waits as long as it asks, if the step’s time allows. Otherwise it fails and says when to try again.

Not in your list? See [When an app isn’t here](https://docs.gorunner.io/apps/when-an-app-isnt-here#q-not-in-list).

## For developers

In the API, which calls apps pieces, Trello is `pieceId: "trello"` with `actionId: "trello"`, set by `resource` and an `operation_…` field, such as `operation_attachment`. Its trigger is `trellotrigger` / `trello_event`. [Get an app](https://docs.gorunner.io/api/apps/get-app) returns every field.

It can change something outside the run (`writes_external`). See [How versions and side effects work](https://docs.gorunner.io/apps#q-versions).

### Trello › Card

### Create

- **List · Required**: The list the card goes in.
- **Name · Optional**: The card's title.
- **Description · Optional**: The card's description (Markdown, up to 16,384 characters).
- **Due Date · Optional**: When the card is due (ISO 8601, such as 2026-11-07T17:00:00Z).
- **Start Date · Optional**: When work on the card starts.
- **Due Date Done · Optional**: Mark the due date done, or not done. Options: Leave as it is, Done, Not done. Default: Leave as it is.
- **Member IDs · Optional**: Members to put on the card. On Update, replaces the card's members.
- **Label IDs · Optional**: Labels to put on the card. On Update, replaces the card's labels.
- **Position · Optional**: top, bottom, or a positive number (Trello orders by it, smallest first).
- **Attach Link · Optional**: A link to attach to the new card.
- **Copy From Card · Optional**: A card to copy: the new card starts as a copy of it.
- **Copy What · Optional**: What to keep from the copied card: all, or some of attachments, checklists, comments, customFields, due, start, labels, members, stickers (separated by commas). Default: all.

### Get, Archive, Unarchive and Delete

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).

### Get Many on a Board

- **Board · Required**: The board whose cards to read.
- **Cards · Optional**: Which cards to read. Options: Open, Archived, Open and archived, Visible to the token's member. Default: Open.
- **Return All · Optional**: Read every card, page by page (at most 1000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many cards to return (1–1000). Default: 50. Shows when **Return All** is off.

### Search

- **Search Text · Required**: What to look for, in Trello's search syntax (such as "launch label:urgent due:week").
- **Board · Optional**: Search only this board. Empty searches every board the token's member can see.
- **Return All · Optional**: Read every card, page by page (at most 1000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many cards to return (1–1000). Default: 50. Shows when **Return All** is off.

### Update

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Name · Optional**: The card's title.
- **Description · Optional**: The card's description (Markdown, up to 16,384 characters).
- **Due Date · Optional**: When the card is due (ISO 8601, such as 2026-11-07T17:00:00Z).
- **Start Date · Optional**: When work on the card starts.
- **Due Date Done · Optional**: Mark the due date done, or not done. Options: Leave as it is, Done, Not done. Default: Leave as it is.
- **Member IDs · Optional**: Members to put on the card. On Update, replaces the card's members.
- **Label IDs · Optional**: Labels to put on the card. On Update, replaces the card's labels.

### Move

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **List · Required**: The list the card goes in.
- **Position · Optional**: top, bottom, or a positive number (Trello orders by it, smallest first).

### Add Member and Remove Member

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Member · Required**: The member to add to or remove from the card (a member of its board).

### Set Custom Field

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Custom Field · Required**: The custom field to set (one of the card's board).
- **Value · Optional**: The value, read by the field's type: text, a number, a date (ISO 8601), true/false for a checkbox, or an option's name for a dropdown. Empty clears it.

### Trello › Card Comment

### Create

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Text · Required**: The comment (Markdown, up to 16,384 characters).

### Get Many

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Return All · Optional**: Read every comment, page by page (at most 1000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many comments to return (1–1000). Default: 50. Shows when **Return All** is off.

### Update

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Comment ID · Required**: The comment's id (the id of its commentCard action).
- **Text · Required**: The comment (Markdown, up to 16,384 characters).

### Delete

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Comment ID · Required**: The comment's id (the id of its commentCard action).

### Trello › Checklist

### Create

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Name · Optional**: The checklist's or item's name. Required for a new checklist item.
- **Position · Optional**: top, bottom, or a positive number (Trello orders by it, smallest first).
- **Copy From Checklist · Optional**: A checklist to copy the items of.

### Get

- **Checklist · Required**: The checklist (one of the card's).

### Get Many and Get Completed Checklist Items

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).

### Delete

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Checklist · Required**: The checklist (one of the card's).

### Create Checklist Item

- **Checklist · Required**: The checklist to add the item to.
- **Name · Optional**: The checklist's or item's name. Required for a new checklist item.
- **Done · Optional**: Add the item already checked. Off by default.
- **Due Date · Optional**: When the item is due (ISO 8601).
- **Position · Optional**: top, bottom, or a positive number (Trello orders by it, smallest first).

### Get Checklist Item and Delete Checklist Item

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Checklist Item · Required**: The item (on one of the card's checklists).

### Update Checklist Item

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Checklist Item · Required**: The item (on one of the card's checklists).
- **Name · Optional**: The checklist's or item's name. Required for a new checklist item.
- **State · Optional**: Check or uncheck the item. Options: Leave as it is, Complete, Incomplete. Default: Leave as it is.
- **Due Date · Optional**: When the item is due (ISO 8601).
- **Position · Optional**: top, bottom, or a positive number (Trello orders by it, smallest first).

### Trello › Label

### Create

- **Board · Required**: The board the label belongs to.
- **Name · Optional**: The label's name. It may be empty for a label that is only a color.
- **Color · Optional**: The label's color. Options: No color, Green, Yellow, Orange, Red, Purple, Blue, Sky, Lime, Pink, Black.

### Get and Delete

- **Label · Required**: The label (from the card's board when a card is given).

### Get Many

- **Board · Required**: The board the label belongs to.
- **Return All · Optional**: Read every label, page by page (at most 1000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many labels to return (1–1000). Default: 50. Shows when **Return All** is off.

### Update

- **Label · Required**: The label (from the card's board when a card is given).
- **Name · Optional**: The label's name. It may be empty for a label that is only a color.
- **Color · Optional**: The label's color. Options: No color, Green, Yellow, Orange, Red, Purple, Blue, Sky, Lime, Pink, Black.

### Add to Card and Remove from Card

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Label · Required**: The label (from the card's board when a card is given).

### Trello › Attachment

### Create

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Attach · Optional**: A link, or a file uploaded to Trello. Options: A link, A file. Default: A link.
- **File · Required**: Upload a file, or switch to an expression to use one from an earlier step (such as {{steps.download.result}}). Trello takes files up to 10 MB on a free Workspace, 250 MB on a paid one. Shows when **Attach** is **A file**.
- **Source URL · Required**: The address to attach. Shows when **Attach** is **A link**.
- **Name · Optional**: The attachment's name in Trello. Default: the link, or the file's name.
- **MIME Type · Optional**: The attachment's type, such as application/pdf. Default: worked out from the file.
- **Make Cover · Optional**: Show the image as the card's cover. Off by default.

### Get, Download and Delete

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Attachment · Required**: The attachment (one of the card's).

### Get Many

- **Card · Required**: The card's id, its short link, or its URL (trello.com/c/…).
- **Return All · Optional**: Read every attachment, page by page (at most 1000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many attachments to return (1–1000). Default: 50. Shows when **Return All** is off.

### Trello › List

### Create

- **Board · Optional**: The board the list is on. On Update, moves the list to this board.
- **Name · Optional**: The list's name. Required for a new list.
- **Position · Optional**: top, bottom, or a positive number (Trello orders by it, smallest first).
- **Copy From List · Optional**: A list to copy, cards included.

### Get, Archive and Unarchive

- **List · Required**: The list.

### Get Many

- **Board · Optional**: The board the list is on. On Update, moves the list to this board.
- **Lists · Optional**: Which lists to read. Options: Open, Archived, Open and archived. Default: Open.
- **Return All · Optional**: Read every item, page by page (at most 1000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many items to return (1–1000). Default: 50. Shows when **Return All** is off.

### Get Cards

- **List · Required**: The list.
- **Return All · Optional**: Read every item, page by page (at most 1000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many items to return (1–1000). Default: 50. Shows when **Return All** is off.

### Update

- **List · Required**: The list.
- **Board · Optional**: The board the list is on. On Update, moves the list to this board.
- **Name · Optional**: The list's name. Required for a new list.
- **Position · Optional**: top, bottom, or a positive number (Trello orders by it, smallest first).

### Trello › Board

### Create

- **Name · Optional**: The board's name. Required for a new board.
- **Description · Optional**: The board's description.
- **Workspace ID · Optional**: The Workspace the board belongs to (its id or short name).
- **Visibility · Optional**: Who can see the board. Default: Trello's (private). Options: Private (board members), Workspace, Public.
- **Background · Optional**: The board's background color. Options: Blue, Orange, Green, Red, Purple, Pink, Lime, Sky, Grey.
- **Add Default Lists · Optional**: Start the board with To Do, Doing and Done. On by default.
- **Add Default Labels · Optional**: Start the board with Trello's six colored labels. On by default.
- **Copy From Board · Optional**: A board to copy (its id or link).
- **Copy Cards · Optional**: Whether a copied board keeps its cards. Options: Keep the cards, Lists only. Default: Keep the cards.

### Get and Delete

- **Board · Required**: The board.

### Get Many

- **Boards · Optional**: Which of your boards to read. Options: Open, Closed, Starred, All. Default: Open.
- **Return All · Optional**: Read every board, page by page (at most 1000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many boards to return (1–1000). Default: 50. Shows when **Return All** is off.

### Update

- **Board · Required**: The board.
- **Name · Optional**: The board's name. Required for a new board.
- **Description · Optional**: The board's description.
- **Workspace ID · Optional**: The Workspace the board belongs to (its id or short name).
- **Visibility · Optional**: Who can see the board. Default: Trello's (private). Options: Private (board members), Workspace, Public.
- **Background · Optional**: The board's background color. Options: Blue, Orange, Green, Red, Purple, Pink, Lime, Sky, Grey.
- **Closed · Optional**: Close the board, or reopen it. Options: Leave as it is, Close, Reopen. Default: Leave as it is.

### Trello › Board Member

### Add

- **Board · Required**: The board.
- **Member · Required**: The member. The list shows the board's members; Add with one of them changes their role.
- **Role · Optional**: What the member may do on the board. Options: Member, Admin, Observer. Default: Member.
- **Allow Billable Guest · Optional**: Allow adding someone from outside the Workspace who would be billed as a guest. Off by default.

### Get Many

- **Board · Required**: The board.
- **Return All · Optional**: Read every member, page by page (at most 1000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many members to return (1–1000). Default: 50. Shows when **Return All** is off.

### Invite

- **Board · Required**: The board.
- **Email · Required**: The address to invite. Trello emails them an invitation.
- **Full Name · Optional**: The invitee's name, for someone without a Trello account.
- **Role · Optional**: What the member may do on the board. Options: Member, Admin, Observer. Default: Member.

### Remove

- **Board · Required**: The board.
- **Member · Required**: The member. The list shows the board's members; Add with one of them changes their role.

Source: https://docs.gorunner.io/apps/trello