Skip to content
Nappai Documentation

Trello Webhook

Trello Webhook is a trigger: the flow runs every time Trello sends a change notice, for example when a card is created, a list is renamed or a board is changed. The component tidies up the notice and tells you what kind of item it is about and what happened. The flow answers with the deployed version; the address Trello must send the notices to appears when you call the flow from another application.

When to use it

  • Notify the team by message every time a new card appears on a board.
  • Record in another tool the changes made in Trello.
  • Ask an AI agent to review every new card and suggest an answer or a label.

Configuration

FieldWhat it does
DataOnly for testing: paste an example of a Trello notice to run the flow without waiting for a real change.

Connect Trello to the flow

  1. Deploy a version of the flow and copy the flow’s address. See Call the flow from another application.
  2. Register a webhook in Trello pointing to that address, with the board, list or card you want to watch. Trello creates webhooks through its developer API, with your account’s key and token.

Output

The Event output returns the tidied-up notice, with these details:

  • type: the kind of item according to Trello’s action: Board, List, Card or Unknown.
  • operation: what happened: Create, Update, Delete, or Unknown for other actions, such as a comment or a member being added.
  • id and name: the ID and name of the item the webhook watches, for example the board.
  • raw_event: the full notice as Trello sends it, with every detail of the change.

If the notice cannot be read, the result contains an error field with the reason.

Connect Event to an agent, a messaging component or the Trello components to act on the item that changed.

Example

A sales team wants to hear in its chat about every new opportunity added to its sales board.

  1. Add Trello Webhook and connect Event to an agent that writes a short notice with the name of the new card.
  2. Connect the agent’s answer to a messaging component.
  3. Deploy the flow and register a webhook in Trello on the sales board with the flow’s address.

Good practices

  • Trello reports every change of the watched item. If you only care about some of them, for example new cards, filter by type and operation at the start of the flow.
  • Test the flow by pasting a real notice into Data before deploying it.