Skip to content
Nappai Documentation

Trello List Component

Trello List Component lets you work with Trello lists directly from your Nappai dashboard.
You can create a new list, read the details of an existing list, list all lists on a board, update a list’s name, or delete a list.
All actions are performed through Trello’s API, so you only need to provide the board or list identifiers and the credentials you set up in Nappai.

How it Works

When you drop the component into a workflow, it connects to Trello using the OAuth token and API key you stored in a Trello Task API credential.
The component then calls the appropriate Trello API endpoint based on the operation you choose:

  • Create – POST /boards/{board_id}/lists
  • Read – GET /lists/{list_id}
  • Read All – GET /boards/{board_id}/lists
  • Update – PUT /lists/{list_id}
  • Delete – DELETE /lists/{list_id}

The result of the API call is returned as a Data output that can be used by other components, or as a Tool output that can be called by an AI agent.

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: Add a new list to a specified board.
  • Read: Get the details of a specific list.
  • Read All: Retrieve all lists on a specified board.
  • Update: Change the name of an existing list.
  • Delete: Remove a list 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 what action the component will perform.

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

  • Board ID: The unique identifier of the Trello board you want to work with.

    • Visible in: Create, Read All

  • List Id: The unique identifier of the Trello list you want to read, update, or delete.

    • Visible in: Read, Update, Delete

  • List Name: The name you want to give to a new list or the new name for an existing list.

    • Visible in: Create, Read, Update

  • Credential: Select the Trello Task API credential you created in Nappai.

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

  • Mapping Mode: Enable mapping mode to process multiple data records in batch.

    • 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.

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

  • Tool Description: A detailed description of what this tool does.

    • 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

Outputs

  • Data: The raw result returned from Trello (e.g., list details, list of lists, or a success status).
  • Tool: A tool representation that can be invoked by an AI agent.

Usage Example

Create a new list

  1. Drag the Trello List Component into your workflow.
  2. Set Operation to Create.
  3. Enter the Board ID of the board where you want the new list.
  4. Provide a List Name (e.g., “Sprint Backlog”).
  5. Select the Trello Task API credential you created.
  6. Run the workflow.
  7. The Data output will contain the new list’s ID and other details, which you can feed into a subsequent component (e.g., to create cards in that list).

Read all lists on a board

  1. Set Operation to Read All.
  2. Enter the Board ID.
  3. Run the workflow.
  4. The Data output will be an array of all lists on that board, which you can iterate over or filter in later steps.
  • Trello Board Component – Manage Trello boards (create, read, update, delete).
  • Trello Card Component – Manage Trello cards (create, read, update, delete).

Tips and Best Practices

  • Keep your Trello credentials secure by storing them in Nappai’s credential manager.
  • Use Mapping Mode when you need to process many lists at once (e.g., bulk‑creating lists from a spreadsheet).
  • When updating a list, double‑check the List Id to avoid renaming the wrong list.
  • Store the Data output in a variable if you plan to use it in multiple downstream components.

Security Considerations

  • The component uses the OAuth token and API key stored in the Trello Task API credential.
  • Never expose these credentials in public workflows or share them with unauthorized users.
  • Nappai encrypts credentials at rest and transmits them over HTTPS to Trello’s API.