Skip to content
Nappai Documentation

Trello Card Component

Trello Card Component connects your flow to your Trello account to work with cards: create a new card in a list, get the details of one card or all the cards in a list, change a card’s name and description, or delete it.

It is useful when tasks start outside Trello, for example in a form, an email or a conversation with an AI agent, and you want them to show up on your board without copying them by hand.

When to use it

  • Every request that arrives through a form on your website should become a card in the “To do” list.
  • You want a daily summary of the cards in a specific list.
  • An AI agent handles requests from the team and needs to create or look up cards on its own.
  • A process finishes in another system and you want to delete the card that represented it.

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.
List ID (required)The list’s ID. Only in Create (the list where the card is created) and Read All (the list whose cards you want).
Card Id (required)The card’s ID. Only in Read, Update and Delete.
Card Name (required)The card’s name. Only in Create and Update.
Card Description (required)The card’s description. Only in Create and Update.

Operations

OperationWhat it does
CreateCreates a new card with the given name and description in the chosen list.
ReadReturns the details of one card.
Read AllReturns all the cards in a list.
UpdateChanges a card’s name and, if you fill it in, its description.
DeleteDeletes the card permanently.

Output

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

You can connect the result to an email or messaging component to notify the team, or to an agent so it can use it in its answer. The component can also be connected to an Agent as a tool, so the agent decides when to create or look up cards. See Tool Mode.

Example

An agency wants every request from its contact form to become a card.

  1. The form reaches the flow with the customer’s name and message.
  2. Add Trello Card Component with the Create operation.
  3. In List ID enter the ID of the “New requests” list, in Card Name the customer’s name and in Card Description their message.

Good practices

  • To read, change or delete a card you need its ID. Keep it when you create the card, or look it up with Read All on its list.
  • Delete cannot be undone. If you only want the card out of sight, move or archive it in Trello.