Skip to content
Nappai Documentation

Trello Label Component

Trello Label Component connects your flow to your Trello account to work with the labels of a card: add one of the board’s labels to it, see the labels it has, or remove one.

It is useful to classify cards automatically, for example to mark requests from key customers as “Urgent” or tasks already paid as “Invoiced”.

When to use it

  • An AI agent reads every new request and decides which priority label it gets.
  • When an invoice is paid you want to mark the order card as “Paid”.
  • Before closing a task you want to check which labels it has.
  • An issue is solved and you want to remove its “Blocked” label.

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.
Card ID (required)The card’s ID. Used in every operation.
Label ID (required)The label’s ID. Only in Create and Delete.

Operations

OperationWhat it does
CreateAdds to the card a label that already exists on the board.
Read AllReturns all the labels the card has.
DeleteRemoves the label from the card. The label still exists on the board.

Output

The Data output returns Trello’s answer. With Read All you get one item per label of the card, with its ID, name and colour. Delete returns a confirmation.

The component can also be connected to an Agent as a tool, so the agent decides which labels to add or remove. See Tool Mode.

Example

A customer service team wants to mark requests from its priority customers as urgent.

  1. Create the “Urgent” label on the Trello board.
  2. Use Read All on a card that already has that label to get its ID.
  3. In the flow, after creating the request card, add Trello Label Component with the Create operation.
  4. In Card ID enter the card’s ID and in Label ID the ID of the “Urgent” label.

Good practices

  • This component does not create new labels: create them first on the Trello board.
  • Each board has its own labels, with their own IDs. A label from one board cannot be used on the cards of another.