Skip to content
Nappai Documentation

Trello Board Component

Trello Board Component connects your flow to your Trello account to work with boards: create a new board, get the details of one board or all the boards in your account, change a board’s name, or delete it.

It is useful when each project, customer or campaign has its own board and you want to create or find it without opening Trello.

When to use it

  • Every new customer that signs up should get their own work board.
  • You want the list of your boards so an agent knows where to look.
  • A project is renamed in your management system and you want the board renamed too.
  • An AI agent handles requests from the team and needs to look up or create boards on its own.

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 Read, Update and Delete.
Board Name (required)The board’s name. Only in Create (name of the new board) and Update (new name).

Operations

OperationWhat it does
CreateCreates a new board with the given name.
ReadReturns the details of one board.
Read AllReturns all the boards of the credential’s account.
UpdateChanges a board’s name.
DeleteDeletes the board permanently.

Output

The Data output returns the board you worked with as Trello stores it: its ID, name and link, among other details. With Read All you get one item per 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 boards. See Tool Mode.

Example

A marketing agency opens a board for every customer that signs.

  1. The flow receives the customer’s name from the sign-up form.
  2. Add Trello Board Component with the Create operation.
  3. In Board Name enter the customer’s name, for example Customer - Ruiz Bakery.
  4. Connect the result to a Trello List Component with the Create operation and the new board’s ID in Board ID to create the work lists.

Good practices

  • To read, rename or delete a board you need its ID. Keep it when you create the board, or look it up with Read All.
  • Delete cannot be undone and takes all the board’s lists and cards with it. If you only want it out of sight, close it in Trello.