Use Trello to manage boards, lists, cards, checklists, labels, and members, or retrieve activity and add comments. Complete the OAuth Allowed Origins setup below before connecting your account.
Before connecting Trello in Sim, add your Sim app origin to the Allowed Origins list for your Trello API key in the Trello Power-Up admin settings.
Trello's authorization flow redirects back to Sim using a return_url. If your Sim origin is not whitelisted in Trello, Trello will block the redirect and the connection flow will fail before Sim can save the token.
Integrate with Trello to list, search, create, update, and delete cards and lists, manage checklists and checklist items, assign labels and members, review activity, and add comments.
List all lists on a Trello board
Parameter Type Required Description boardIdstring Yes Trello board ID (24-character hex string) filterstring No Which lists to return: open, closed, or all (defaults to open)
Parameter Type Description listsarray Lists on the selected board ↳ id string List ID ↳ name string List name ↳ closed boolean Whether the list is archived ↳ pos number List position on the board ↳ idBoard string Board ID containing the list countnumber Number of lists returned
List cards from a Trello board or list
Parameter Type Required Description boardIdstring No Trello board ID to list open cards from. Provide either boardId or listId listIdstring No Trello list ID to list cards from. Provide either boardId or listId filterstring No Which cards to return: open, closed, or all (defaults to open)
Parameter Type Description cardsarray Cards returned from the selected Trello board or list ↳ id string Card ID ↳ name string Card name ↳ desc string Card description ↳ url string Full card URL ↳ idBoard string Board ID containing the card ↳ idList string List ID containing the card ↳ closed boolean Whether the card is archived ↳ labelIds array Label IDs applied to the card ↳ labels array Labels applied to the card ↳ id string Label ID ↳ name string Label name ↳ color string Label color ↳ due string Card due date in ISO 8601 format ↳ dueComplete boolean Whether the due date is complete countnumber Number of cards returned
Search Trello cards and boards by keyword
Parameter Type Required Description querystring Yes Search text, supports Trello search operators (e.g. board:, list:, due:) idBoardsarray No Restrict the search to these board IDs modelTypesstring No Comma-separated result types to search: cards, boards, or all (default all) cardsLimitnumber No Maximum number of cards to return (1-1000, default 10)
Parameter Type Description cardsarray Cards matching the search query ↳ id string Card ID ↳ name string Card name ↳ desc string Card description ↳ url string Full card URL ↳ idBoard string Board ID containing the card ↳ idList string List ID containing the card ↳ closed boolean Whether the card is archived boardsarray Boards matching the search query ↳ id string Board ID ↳ name string Board name ↳ desc string Board description ↳ url string Full board URL ↳ closed boolean Whether the board is archived ↳ idOrganization string Workspace/organization ID that owns the board countnumber Total number of cards and boards returned
Create a new card in a Trello list
Parameter Type Required Description listIdstring Yes Trello list ID (24-character hex string) namestring Yes Name/title of the card descstring No Description of the card posstring No Position of the card (top, bottom, or positive float) duestring No Due date (ISO 8601 format) dueCompleteboolean No Whether the due date should be marked complete labelIdsarray No Label IDs to attach to the card memberIdsarray No Member IDs to assign to the card
Parameter Type Description cardjson Created card (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete) ↳ id string Card ID ↳ name string Card name ↳ desc string Card description ↳ url string Full card URL ↳ idBoard string Board ID containing the card ↳ idList string List ID containing the card ↳ closed boolean Whether the card is archived ↳ labelIds array Label IDs applied to the card ↳ labels array Labels applied to the card ↳ id string Label ID ↳ name string Label name ↳ color string Label color ↳ due string Card due date in ISO 8601 format ↳ dueComplete boolean Whether the due date is complete
Update an existing card on Trello
Parameter Type Required Description cardIdstring Yes Trello card ID (24-character hex string) namestring No New name/title of the card descstring No New description of the card closedboolean No Archive/close the card (true) or reopen it (false) idListstring No Trello list ID to move card to (24-character hex string) duestring No Due date (ISO 8601 format) dueCompleteboolean No Mark the due date as complete
Parameter Type Description cardjson Updated card (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete) ↳ id string Card ID ↳ name string Card name ↳ desc string Card description ↳ url string Full card URL ↳ idBoard string Board ID containing the card ↳ idList string List ID containing the card ↳ closed boolean Whether the card is archived ↳ labelIds array Label IDs applied to the card ↳ labels array Labels applied to the card ↳ id string Label ID ↳ name string Label name ↳ color string Label color ↳ due string Card due date in ISO 8601 format ↳ dueComplete boolean Whether the due date is complete
Permanently delete a Trello card
Parameter Type Required Description cardIdstring Yes Trello card ID to permanently delete (24-character hex string)
Parameter Type Description successboolean Whether the card was deleted
Get activity/actions from a board or card
Parameter Type Required Description boardIdstring No Trello board ID (24-character hex string). Either boardId or cardId required cardIdstring No Trello card ID (24-character hex string). Either boardId or cardId required filterstring No Filter actions by type (e.g., "commentCard,updateCard,createCard" or "all") limitnumber No Maximum number of board actions to return pagenumber No Page number for action results sincestring No Only return actions after this date (ISO 8601 timestamp) or action ID, for paging through long histories beforestring No Only return actions before this date (ISO 8601 timestamp) or action ID, for paging through long histories
Parameter Type Description actionsarray Action items (id, type, date, idMemberCreator, text, memberCreator, card, board, list) ↳ id string Action ID ↳ type string Action type ↳ date string Action timestamp ↳ idMemberCreator string ID of the member who created the action ↳ text string Comment text when present ↳ memberCreator object Member who created the action ↳ id string Member ID ↳ fullName string Member full name ↳ username string Member username ↳ card object Card referenced by the action ↳ id string Card ID ↳ name string Card name ↳ shortLink string Short card link ↳ idShort number Board-local card number ↳ due string Card due date ↳ board object Board referenced by the action ↳ id string Board ID ↳ name string Board name ↳ shortLink string Short board link ↳ list object List referenced by the action ↳ id string List ID ↳ name string List name countnumber Number of actions returned
Add a comment to a Trello card
Parameter Type Required Description cardIdstring Yes Trello card ID (24-character hex string) textstring Yes Comment text
Parameter Type Description commentjson Created comment action (id, type, date, idMemberCreator, text, memberCreator, card, board, list) ↳ id string Action ID ↳ type string Action type ↳ date string Action timestamp ↳ idMemberCreator string ID of the member who created the comment ↳ text string Comment text ↳ memberCreator object Member who created the comment ↳ id string Member ID ↳ fullName string Member full name ↳ username string Member username ↳ card object Card referenced by the comment ↳ id string Card ID ↳ name string Card name ↳ shortLink string Short card link ↳ idShort number Board-local card number ↳ due string Card due date ↳ board object Board referenced by the comment ↳ id string Board ID ↳ name string Board name ↳ shortLink string Short board link ↳ list object List referenced by the comment ↳ id string List ID ↳ name string List name
Create a new Trello board
Parameter Type Required Description namestring Yes Name of the board descstring No Description of the board idOrganizationstring No ID or name of the workspace/organization the board belongs to defaultListsboolean No Whether to create the default lists (To Do, Doing, Done) on the new board
Parameter Type Description boardjson Created board (id, name, desc, url, closed, idOrganization) ↳ id string Board ID ↳ name string Board name ↳ desc string Board description ↳ url string Full board URL ↳ closed boolean Whether the board is closed ↳ idOrganization string ID of the workspace/organization the board belongs to
Retrieve a single Trello board by ID
Parameter Type Required Description boardIdstring Yes Trello board ID (24-character hex string)
Parameter Type Description boardjson Board (id, name, desc, url, closed, idOrganization) ↳ id string Board ID ↳ name string Board name ↳ desc string Board description ↳ url string Full board URL ↳ closed boolean Whether the board is closed ↳ idOrganization string ID of the workspace/organization the board belongs to
Create a new list on a Trello board
Parameter Type Required Description boardIdstring Yes Trello board ID the list belongs to (24-character hex string) namestring Yes Name of the list posstring No Position of the list (top, bottom, or positive float)
Parameter Type Description listjson Created list (id, name, closed, pos, idBoard) ↳ id string List ID ↳ name string List name ↳ closed boolean Whether the list is archived ↳ pos number List position on the board ↳ idBoard string Board ID containing the list
Rename, move, archive, or reopen a Trello list
Parameter Type Required Description listIdstring Yes Trello list ID (24-character hex string) namestring No New name of the list closedboolean No Archive the list (true) or reopen it (false) idBoardstring No Board ID to move the list to (24-character hex string) posstring No New position of the list (top, bottom, or positive float)
Parameter Type Description listjson Updated list (id, name, closed, pos, idBoard) ↳ id string List ID ↳ name string List name ↳ closed boolean Whether the list is archived ↳ pos number List position on the board ↳ idBoard string Board ID containing the list
Retrieve a single Trello card by ID
Parameter Type Required Description cardIdstring Yes Trello card ID (24-character hex string)
Parameter Type Description cardjson Card (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete) ↳ id string Card ID ↳ name string Card name ↳ desc string Card description ↳ url string Full card URL ↳ idBoard string Board ID containing the card ↳ idList string List ID containing the card ↳ closed boolean Whether the card is archived ↳ labelIds array Label IDs applied to the card ↳ labels array Labels applied to the card ↳ id string Label ID ↳ name string Label name ↳ color string Label color ↳ due string Card due date in ISO 8601 format ↳ dueComplete boolean Whether the due date is complete
Add a checklist to a Trello card
Parameter Type Required Description cardIdstring Yes Trello card ID to add the checklist to (24-character hex string) namestring Yes Name of the checklist posstring No Position of the checklist (top, bottom, or positive float)
Parameter Type Description checklistjson Created checklist (id, name, idCard, idBoard, pos) ↳ id string Checklist ID ↳ name string Checklist name ↳ idCard string Card ID containing the checklist ↳ idBoard string Board ID containing the checklist ↳ pos number Checklist position on the card
Add an item to a Trello checklist
Parameter Type Required Description checklistIdstring Yes Trello checklist ID to add the item to (24-character hex string) namestring Yes Name of the checklist item posstring No Position of the item (top, bottom, or positive float) checkedboolean No Whether the item should start checked off
Parameter Type Description itemjson Created checklist item (id, name, state, pos, idChecklist) ↳ id string Checklist item ID ↳ name string Checklist item name ↳ state string Item state (complete or incomplete) ↳ pos number Item position on the checklist ↳ idChecklist string Checklist ID containing the item
Check off, uncheck, or rename a Trello checklist item
Parameter Type Required Description cardIdstring Yes Trello card ID that owns the checklist item (24-character hex string) checkItemIdstring Yes Checklist item ID to update (24-character hex string) statestring No Set the item state to complete or incomplete namestring No New name for the checklist item
Parameter Type Description itemjson Updated checklist item (id, name, state, pos, idChecklist) ↳ id string Checklist item ID ↳ name string Checklist item name ↳ state string Item state (complete or incomplete) ↳ pos number Item position on the checklist ↳ idChecklist string Checklist ID containing the item
Attach an existing label to a Trello card
Parameter Type Required Description cardIdstring Yes Trello card ID to attach the label to (24-character hex string) labelIdstring Yes ID of the label to attach (24-character hex string)
Parameter Type Description labelIdsarray Label IDs now applied to the card
Detach a label from a Trello card
Parameter Type Required Description cardIdstring Yes Trello card ID to detach the label from (24-character hex string) labelIdstring Yes ID of the label to detach (24-character hex string)
Parameter Type Description successboolean Whether the label was removed from the card
Assign a member to a Trello card
Parameter Type Required Description cardIdstring Yes Trello card ID to assign the member to (24-character hex string) memberIdstring Yes ID of the member to assign (24-character hex string)
Parameter Type Description memberIdsarray Member IDs now assigned to the card
Unassign a member from a Trello card
Parameter Type Required Description cardIdstring Yes Trello card ID to unassign the member from (24-character hex string) memberIdstring Yes ID of the member to unassign (24-character hex string)
Parameter Type Description successboolean Whether the member was removed from the card
List members of a Trello board
Parameter Type Required Description boardIdstring Yes Trello board ID (24-character hex string)
Parameter Type Description membersarray Members on the selected board ↳ id string Member ID ↳ fullName string Member full name ↳ username string Member username countnumber Number of members returned
Sim requests these scopes when someone connects a Trello account. On a self-hosted deployment, register your own app with the provider using the settings below. See Integrations & OAuth for the full setup.
Setting Value Environment variables TRELLO_API_KEY
Scope Description readRead boards, lists, cards, and workspaces writeCreate and update boards, lists, and cards