AACFlow

Trello

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

With Trello in AACFlow.io, 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 AACFlow.io 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 AACFlow.io, add your AACFlow.io 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 AACFlow.io using a return_url. If your AACFlow.io origin is not whitelisted in Trello, Trello will block the redirect and the connection flow will fail before AACFlow.io 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.

Actions

trello_list_lists

List all lists on a Trello board

Input

ParameterTypeRequiredDescription
boardIdstringYesTrello board ID (24-character hex string)
filterstringNoWhich lists to return: open, closed, or all (defaults to open)

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
filterstringNoWhich cards to return: open, closed, or all (defaults to open)

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

Search Trello cards and boards by keyword

Input

ParameterTypeRequiredDescription
querystringYesSearch text, supports Trello search operators (e.g. board:, list:, due:)
idBoardsarrayNoRestrict the search to these board IDs
modelTypesstringNoComma-separated result types to search: cards, boards, or all (default all)
cardsLimitnumberNoMaximum number of cards to return (1-1000, default 10)

Output

ParameterTypeDescription
cardsarrayCards matching the search query
idstringCard ID
namestringCard name
descstringCard description
urlstringFull card URL
idBoardstringBoard ID containing the card
idListstringList ID containing the card
closedbooleanWhether the card is archived
boardsarrayBoards matching the search query
idstringBoard ID
namestringBoard name
descstringBoard description
urlstringFull board URL
closedbooleanWhether the board is archived
idOrganizationstringWorkspace/organization ID that owns the board
countnumberTotal number of cards and boards 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
memberIdsarrayNoMember IDs to assign to the card

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_delete_card

Permanently delete a Trello card

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID to permanently delete (24-character hex string)

Output

ParameterTypeDescription
successbooleanWhether the card was deleted

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
sincestringNoOnly return actions after this date (ISO 8601 timestamp) or action ID, for paging through long histories
beforestringNoOnly return actions before this date (ISO 8601 timestamp) or action ID, for paging through long histories

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

trello_create_board

Create a new Trello board

Input

ParameterTypeRequiredDescription
namestringYesName of the board
descstringNoDescription of the board
idOrganizationstringNoID or name of the workspace/organization the board belongs to
defaultListsbooleanNoWhether to create the default lists (To Do, Doing, Done) on the new board

Output

ParameterTypeDescription
boardjsonCreated board (id, name, desc, url, closed, idOrganization)
idstringBoard ID
namestringBoard name
descstringBoard description
urlstringFull board URL
closedbooleanWhether the board is closed
idOrganizationstringID of the workspace/organization the board belongs to

trello_get_board

Retrieve a single Trello board by ID

Input

ParameterTypeRequiredDescription
boardIdstringYesTrello board ID (24-character hex string)

Output

ParameterTypeDescription
boardjsonBoard (id, name, desc, url, closed, idOrganization)
idstringBoard ID
namestringBoard name
descstringBoard description
urlstringFull board URL
closedbooleanWhether the board is closed
idOrganizationstringID of the workspace/organization the board belongs to

trello_create_list

Create a new list on a Trello board

Input

ParameterTypeRequiredDescription
boardIdstringYesTrello board ID the list belongs to (24-character hex string)
namestringYesName of the list
posstringNoPosition of the list (top, bottom, or positive float)

Output

ParameterTypeDescription
listjsonCreated list (id, name, closed, pos, idBoard)
idstringList ID
namestringList name
closedbooleanWhether the list is archived
posnumberList position on the board
idBoardstringBoard ID containing the list

trello_update_list

Rename, move, archive, or reopen a Trello list

Input

ParameterTypeRequiredDescription
listIdstringYesTrello list ID (24-character hex string)
namestringNoNew name of the list
closedbooleanNoArchive the list (true) or reopen it (false)
idBoardstringNoBoard ID to move the list to (24-character hex string)
posstringNoNew position of the list (top, bottom, or positive float)

Output

ParameterTypeDescription
listjsonUpdated list (id, name, closed, pos, idBoard)
idstringList ID
namestringList name
closedbooleanWhether the list is archived
posnumberList position on the board
idBoardstringBoard ID containing the list

trello_get_card

Retrieve a single Trello card by ID

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID (24-character hex string)

Output

ParameterTypeDescription
cardjsonCard (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_add_checklist

Add a checklist to a Trello card

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID to add the checklist to (24-character hex string)
namestringYesName of the checklist
posstringNoPosition of the checklist (top, bottom, or positive float)

Output

ParameterTypeDescription
checklistjsonCreated checklist (id, name, idCard, idBoard, pos)
idstringChecklist ID
namestringChecklist name
idCardstringCard ID containing the checklist
idBoardstringBoard ID containing the checklist
posnumberChecklist position on the card

trello_add_checklist_item

Add an item to a Trello checklist

Input

ParameterTypeRequiredDescription
checklistIdstringYesTrello checklist ID to add the item to (24-character hex string)
namestringYesName of the checklist item
posstringNoPosition of the item (top, bottom, or positive float)
checkedbooleanNoWhether the item should start checked off

Output

ParameterTypeDescription
itemjsonCreated checklist item (id, name, state, pos, idChecklist)
idstringChecklist item ID
namestringChecklist item name
statestringItem state (complete or incomplete)
posnumberItem position on the checklist
idCheckliststringChecklist ID containing the item

trello_update_checklist_item

Check off, uncheck, or rename a Trello checklist item

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID that owns the checklist item (24-character hex string)
checkItemIdstringYesChecklist item ID to update (24-character hex string)
statestringNoSet the item state to complete or incomplete
namestringNoNew name for the checklist item

Output

ParameterTypeDescription
itemjsonUpdated checklist item (id, name, state, pos, idChecklist)
idstringChecklist item ID
namestringChecklist item name
statestringItem state (complete or incomplete)
posnumberItem position on the checklist
idCheckliststringChecklist ID containing the item

trello_add_label

Attach an existing label to a Trello card

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID to attach the label to (24-character hex string)
labelIdstringYesID of the label to attach (24-character hex string)

Output

ParameterTypeDescription
labelIdsarrayLabel IDs now applied to the card

trello_remove_label

Detach a label from a Trello card

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID to detach the label from (24-character hex string)
labelIdstringYesID of the label to detach (24-character hex string)

Output

ParameterTypeDescription
successbooleanWhether the label was removed from the card

trello_add_member

Assign a member to a Trello card

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID to assign the member to (24-character hex string)
memberIdstringYesID of the member to assign (24-character hex string)

Output

ParameterTypeDescription
memberIdsarrayMember IDs now assigned to the card

trello_remove_member

Unassign a member from a Trello card

Input

ParameterTypeRequiredDescription
cardIdstringYesTrello card ID to unassign the member from (24-character hex string)
memberIdstringYesID of the member to unassign (24-character hex string)

Output

ParameterTypeDescription
successbooleanWhether the member was removed from the card

trello_list_members

List members of a Trello board

Input

ParameterTypeRequiredDescription
boardIdstringYesTrello board ID (24-character hex string)

Output

ParameterTypeDescription
membersarrayMembers on the selected board
idstringMember ID
fullNamestringMember full name
usernamestringMember username
countnumberNumber of members returned

On this page