Skip to content
Nappai Documentation

Trello Board Component

This component lets you manage Trello boards directly from your Nappai dashboard. You can create new boards, view details of an existing board, list all boards, update a board’s name, or delete a board. It works with your Trello credentials and can be used in a workflow or as a tool for an AI agent.

How it Works

The Trello Board Component talks to Trello’s REST API. When you set up the component, you provide a Trello OAuth token and API key (via a credential you configure in Nappai). The component then sends HTTP requests to Trello to perform the chosen operation. All calls are made asynchronously, so you can run several board actions at the same time without blocking the dashboard. If you enable Mapping Mode, the component can process many boards in a single batch, taking input from other components or from a list you supply.

Operations

This component offers several operations that you can select based on what you need to do. You can only use one operation at a time:

  • Create: Creates a new Trello board with the specified name.
  • Read: Retrieves details of a specific board by its ID.
  • Read All: Retrieves a list of all boards in your Trello account.
  • Update: Changes the name of an existing board.
  • Delete: Removes a board from Trello.

To use the component, first select the operation you need in the “Operation” field.

Inputs

Mapping Mode

This component has a special mode called “Mapping Mode”. When you enable this mode using the toggle switch, an additional input called “Mapping Data” is activated, and each input field offers you three different ways to provide data:

  • Fixed: You type the value directly into the field.
  • Mapped: You connect the output of another component to use its result as the value.
  • Javascript: You write Javascript code to dynamically calculate the value.

This flexibility allows you to create more dynamic and connected workflows.

Input Fields

The following fields are available to configure this component. Each field may be visible in different operations:

  • Operation: Choose one of the five available actions.

    • Visible in: Create, Read, Read All, Update, Delete

  • Board ID: The unique identifier of the board you want to read, update, or delete.

    • Visible in: Read, Update, Delete

  • Board Name: The name you want to give a new board or use when updating an existing board.

    • Visible in: Create, Update

  • Mapping Mode: Toggle to enable batch processing of multiple records.

    • Visible in: Create, Read, Read All, Update, Delete

  • Tool Name: The name of the tool that will be used when this component is connected as a tool. This name will be displayed to the agent when it selects tools to use.

    • Visible in: Create, Read, Read All, Update, Delete

  • Tool Description: A detailed description of what this tool does. This description will help the agent understand when and how to use this tool effectively.

    • Visible in: Create, Read, Read All, Update, Delete

  • Tools arguments metadata: Defines the arguments metadata for the tools.

    • Visible in: Create, Read, Read All, Update, Delete

Note: This component requires a Trello Task API credential.

  1. Configure the “Trello Task API” credential in the Nappai Credentials section.
  2. Select that credential in the component’s “Credential” field (this field is not listed here because it is automatically added by Nappai).

Outputs

  • Data: The raw data returned from Trello (e.g., board details, list of boards, or a success status). This output is produced by the perform_action method and can be used in subsequent components or displayed in the dashboard.
  • Tool: A tool representation that can be used by Nappai’s AI agents. It is generated by the to_toolkit method and includes the operation, arguments, and description you provided.

Usage Example

Creating a new board

  1. Set Operation to Create.
  2. Enter a Board Name (e.g., “Project Alpha”).
  3. Enable Mapping Mode if you want to create multiple boards at once.
  4. Click Run.
  5. The Data output will contain the new board’s ID and details.

Listing all boards

  1. Set Operation to Read All.
  2. Click Run.
  3. The Data output will be a list of all boards in your Trello account, which you can then feed into another component or display in a table.
  • Trello List Component – Manage lists within a Trello board (create, read, update, delete).
  • Trello Card Component – Manage cards within a Trello list (create, read, update, delete).

Tips and Best Practices

  • Use Mapping Mode when you need to perform the same operation on many boards at once; it saves time and reduces API calls.
  • Keep your Trello OAuth token and API key secure; store them in Nappai’s credential manager rather than hard‑coding them.
  • Test each operation with a single board first to confirm the settings before running batch operations.
  • When deleting boards, double‑check the Board ID to avoid accidental data loss.
  • Use the Tool output to let AI agents automatically manage boards based on natural language requests.

Security Considerations

  • Trello credentials are sensitive. Store them in Nappai’s credential vault and never expose them in logs or UI.
  • The component uses HTTPS to communicate with Trello, ensuring data is encrypted in transit.
  • If you enable Mapping Mode, be mindful of the number of API calls; excessive requests can trigger Trello’s rate limits.