AptlyStar

Trello

Manage Trello lists, cards, and activity

Trello is a visual collaboration tool that helps you organize projects, tasks, and workflows using boards, lists, and cards.

With Trello in Aptlystar, you can:

  • List boards and lists: View the boards you have access to and their associated lists.
  • List and search cards: Retrieve all cards on a board or filter by list to see their content and status.
  • Create cards: Add new cards to a Trello list, including descriptions, labels, and due dates.
  • Update and move cards: Edit card properties, move cards across lists, and set due dates or labels.
  • Get recent activity: Retrieve actions and activity history for boards and cards.
  • Comment on cards: Add comments to cards for collaboration and tracking.

Integrating Trello with Aptlystar empowers your agents to manage your team’s tasks, boards, and projects programmatically. Automate project management workflows, keep task lists up-to-date, synchronize with other tools, or trigger intelligent workflows in response to Trello events—all through your AI agents.

Usage Instructions

Trello OAuth Setup

Before connecting Trello in Aptlystar, add your Aptlystar 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 Aptlystar using a return_url. If your Aptlystar origin is not whitelisted in Trello, Trello will block the redirect and the connection flow will fail before Aptlystar can save the token.

Integrate with Trello to list board lists, list cards, create cards, update cards, review activity, and add comments.

Tools

trello_list_lists

List all lists on a Trello board

Input

ParameterTypeRequiredDescription
boardIdstringYesTrello board ID (24-character hex string)

Output

ParameterTypeDescription
listsarrayLists on the selected board
↳ idstringList ID
↳ namestringList name
↳ closedbooleanWhether the list is archived
↳ posnumberList position on the board
↳ idBoardstringBoard ID containing the list
countnumberNumber of lists returned

trello_list_cards

List cards from a Trello board or list

Input

ParameterTypeRequiredDescription
boardIdstringNoTrello board ID to list open cards from. Provide either boardId or listId
listIdstringNoTrello list ID to list cards from. Provide either boardId or listId

Output

ParameterTypeDescription
cardsarrayCards returned from the selected Trello board or list
↳ idstringCard ID
↳ namestringCard name
↳ descstringCard description
↳ urlstringFull card URL
↳ idBoardstringBoard ID containing the card
↳ idListstringList ID containing the card
↳ closedbooleanWhether the card is archived
↳ labelIdsarrayLabel IDs applied to the card
↳ labelsarrayLabels applied to the card
↳ idstringLabel ID
↳ namestringLabel name
↳ colorstringLabel color
↳ duestringCard due date in ISO 8601 format
↳ dueCompletebooleanWhether the due date is complete
countnumberNumber of cards returned

trello_create_card

Create a new card in a Trello list

Input

ParameterTypeRequiredDescription
listIdstringYesTrello list ID (24-character hex string)
namestringYesName/title of the card
descstringNoDescription of the card
posstringNoPosition of the card (top, bottom, or positive float)
duestringNoDue date (ISO 8601 format)
dueCompletebooleanNoWhether the due date should be marked complete
labelIdsarrayNoLabel IDs to attach to the card
itemsstringNoA Trello label ID

Output

ParameterTypeDescription
cardjsonCreated card (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete)
↳ idstringCard ID
↳ namestringCard name
↳ descstringCard description
↳ urlstringFull card URL
↳ idBoardstringBoard ID containing the card
↳ idListstringList ID containing the card
↳ closedbooleanWhether the card is archived
↳ labelIdsarrayLabel IDs applied to the card
↳ labelsarrayLabels applied to the card
↳ idstringLabel ID
↳ namestringLabel name
↳ colorstringLabel color
↳ duestringCard due date in ISO 8601 format
↳ dueCompletebooleanWhether the due date is complete

trello_update_card

Update an existing card on Trello

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID (24-character hex string)
namestringNoNew name/title of the card
descstringNoNew description of the card
closedbooleanNoArchive/close the card (true) or reopen it (false)
idListstringNoTrello list ID to move card to (24-character hex string)
duestringNoDue date (ISO 8601 format)
dueCompletebooleanNoMark the due date as complete

Output

ParameterTypeDescription
cardjsonUpdated card (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete)
↳ idstringCard ID
↳ namestringCard name
↳ descstringCard description
↳ urlstringFull card URL
↳ idBoardstringBoard ID containing the card
↳ idListstringList ID containing the card
↳ closedbooleanWhether the card is archived
↳ labelIdsarrayLabel IDs applied to the card
↳ labelsarrayLabels applied to the card
↳ idstringLabel ID
↳ namestringLabel name
↳ colorstringLabel color
↳ duestringCard due date in ISO 8601 format
↳ dueCompletebooleanWhether the due date is complete

trello_get_actions

Get activity/actions from a board or card

Input

ParameterTypeRequiredDescription
boardIdstringNoTrello board ID (24-character hex string). Either boardId or cardId required
cardIdstringNoTrello card ID (24-character hex string). Either boardId or cardId required
filterstringNoFilter actions by type (e.g., "commentCard,updateCard,createCard" or "all")
limitnumberNoMaximum number of board actions to return
pagenumberNoPage number for action results

Output

ParameterTypeDescription
actionsarrayAction items (id, type, date, idMemberCreator, text, memberCreator, card, board, list)
↳ idstringAction ID
↳ typestringAction type
↳ datestringAction timestamp
↳ idMemberCreatorstringID of the member who created the action
↳ textstringComment text when present
↳ memberCreatorobjectMember who created the action
↳ idstringMember ID
↳ fullNamestringMember full name
↳ usernamestringMember username
↳ cardobjectCard referenced by the action
↳ idstringCard ID
↳ namestringCard name
↳ shortLinkstringShort card link
↳ idShortnumberBoard-local card number
↳ duestringCard due date
↳ boardobjectBoard referenced by the action
↳ idstringBoard ID
↳ namestringBoard name
↳ shortLinkstringShort board link
↳ listobjectList referenced by the action
↳ idstringList ID
↳ namestringList name
countnumberNumber of actions returned

trello_add_comment

Add a comment to a Trello card

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID (24-character hex string)
textstringYesComment text

Output

ParameterTypeDescription
commentjsonCreated comment action (id, type, date, idMemberCreator, text, memberCreator, card, board, list)
↳ idstringAction ID
↳ typestringAction type
↳ datestringAction timestamp
↳ idMemberCreatorstringID of the member who created the comment
↳ textstringComment text
↳ memberCreatorobjectMember who created the comment
↳ idstringMember ID
↳ fullNamestringMember full name
↳ usernamestringMember username
↳ cardobjectCard referenced by the comment
↳ idstringCard ID
↳ namestringCard name
↳ shortLinkstringShort card link
↳ idShortnumberBoard-local card number
↳ duestringCard due date
↳ boardobjectBoard referenced by the comment
↳ idstringBoard ID
↳ namestringBoard name
↳ shortLinkstringShort board link
↳ listobjectList referenced by the comment
↳ idstringList ID
↳ namestringList name

On this page