Skip to content
Nappai Documentation

Trello Card Component

The Trello Card Component lets you create, read, update, and delete Trello cards directly from your Nappai dashboard. It connects to Trello’s API using a credential you set up in Nappai, so you can automate card management without leaving the platform.

How it Works

When you add this component to a workflow, it uses the Trello API to perform the chosen operation. The component first reads the credentials you selected (OAuth token and API key) and then calls the appropriate Trello endpoint:

  • Create – Adds a new card to a specified list.
  • Read – Retrieves a single card’s details.
  • Read All – Lists all cards in a specified list.
  • Update – Changes a card’s name or description.
  • Delete – Removes a card from Trello.

All data returned from Trello is wrapped in a Nappai Data object, which can be passed to other components or used as a tool for 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 card to a Trello list.
  • Read: Get the details of a specific card.
  • Read All: List all cards in a specific list.
  • Update: Change the name or description of an existing card.
  • Delete: Remove a card 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 the component will do.

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

  • Credential: Select the Trello Task API credential that contains your OAuth token and API key.

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

  • Card Description: The text that will appear on the card.

    • Visible in: Create, Update

  • Card Id: The unique ID of the card you want to read, update, or delete.

    • Visible in: Read, Update, Delete

  • Card Name: The title of the card.

    • Visible in: Create, Update

  • List ID: The ID of the Trello list where the card will be created or from which cards will be listed.

    • Visible in: Create, Read All

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

Outputs

  • Data: The result of the Trello API call, wrapped in a Nappai Data object. This can be used as input for other components or displayed in the dashboard.
  • Tool: A tool representation that can be used by an AI agent when the component is connected as a tool.

Usage Example

Creating a new card

  1. Drag the Trello Card Component into your workflow.
  2. Set Operation to Create.
  3. Choose the Credential you created for Trello.
  4. Enter the List ID of the list where the card should appear.
  5. Provide a Card Name and Card Description.
  6. (Optional) Enable Mapping Mode if you want to create multiple cards from a list of data.
  7. Connect the Data output to the next component or to a display node.

Reading all cards in a list

  1. Set Operation to Read All.
  2. Provide the List ID.
  3. The component will output a list of card objects in the Data field, which you can iterate over or filter in subsequent steps.
  • Trello Board Component – Manage Trello boards (create, read, update, delete).
  • Trello List Component – Manage Trello lists within a board (create, read, update, delete).

Tips and Best Practices

  • Use Mapping Mode when you need to process many cards at once; it saves time and reduces API calls.
  • Keep your Trello credentials in the Nappai credential store and never hard‑code them in the workflow.
  • When using the component as a tool for an AI agent, set a clear Tool Name and Tool Description so the agent can choose the right tool.
  • Test each operation separately before chaining them together to ensure the correct data is passed.

Security Considerations

  • Store your Trello OAuth token and API key in Nappai’s secure credential store.
  • Only share the component with users who have permission to access the Trello boards you are working with.
  • Enable Mapping Mode only when you trust the data source, as it can trigger many API calls in a short time.