Skip to content
Nappai Documentation

Trello List Component

Trello List Component connects your flow to your Trello account to work with the lists of a board: create a new list, get the details of one list or all the lists of a board, change a list’s name, or archive it.

It is useful to set up a board’s structure automatically, for example the “To do”, “Doing” and “Done” columns, or to find out the IDs of the lists that other Trello components use.

When to use it

  • When you create the board of a new project you want it to always have the same lists.
  • You need a list’s ID to create cards in it with Trello Card Component.
  • You want to rename a list, for example with the current month.
  • A work stage ends and you want to remove its list from the board.

Configuration

You need a Trello Task API credential with your Trello account’s token and API key. See Credentials.

FieldWhat it does
Credential (required)The Trello Task API credential used to access your account.
OperationWhat the component does. See Operations. Default: Create.
Board ID (required)The board’s ID. Only in Create (the board where the list is created) and Read All (the board whose lists you want).
List Id (required)The list’s ID. Only in Read, Update and Delete.
List Name (required)The list’s name. Only in Create (name of the new list) and Update (new name).

Operations

OperationWhat it does
CreateCreates a new list with the given name in the chosen board.
ReadReturns the details of one list.
Read AllReturns all the lists of a board.
UpdateChanges a list’s name.
DeleteArchives the list: it disappears from the board, but it can be restored from Trello’s archived items.

Output

The Data output returns the list you worked with as Trello stores it: its ID, name and the board it belongs to, among other details. With Read All you get one item per list of the board. Delete returns a confirmation.

The component can also be connected to an Agent as a tool, so the agent decides when to create or look up lists. See Tool Mode.

Example

A design studio wants every project board to start with the lists of its process.

  1. A Trello Board Component creates the project board.
  2. Add Trello List Component with the Create operation.
  3. In Board ID enter the ID of the board just created and in List Name Briefing.
  4. Repeat the previous step with Sketches, Customer review and Delivered.

Good practices

  • Delete does not erase the list: it archives it. If you need it again, restore it in Trello.
  • Use Read All to get the IDs of a board’s lists before creating cards in them.