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
- In the sidebar, open Connections and press Add connection.
- Type
trelloand choose Trello. - Fill in the fields. Each one says Required or Optional.
- 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 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 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.
Do things in Trello
Add a Trello step, choose a Resource, then an Operation. Choose a row to see its fields.
- CardCreate · Get · Get Many on a Board · Search · Update · Move · Archive · Unarchive · Add Member · Remove Member · Set Custom Field · Delete
- Card CommentCreate · Get Many · Update · Delete
- ChecklistCreate · Get · Get Many · Delete · Create Checklist Item · Get Checklist Item · Update Checklist Item · Delete Checklist Item · Get Completed Checklist Items
- LabelCreate · Get · Get Many · Update · Delete · Add to Card · Remove from Card
- AttachmentCreate · Get · Get Many · Download · Delete
- ListCreate · Get · Get Many · Get Cards · Update · Archive · Unarchive
- BoardCreate · Get · Get Many · Update · Delete
- Board MemberAdd · Get Many · Invite · Remove
Later steps read a step’s output by its name: see 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.
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 returns every field.
It can change something outside the run (writes_external). See How versions and side effects work.
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.