Skip to content
Nappai Documentation

Trello Comment Component

The Trello Comment Component lets you add, read, update, or delete comments on Trello cards directly from your Nappai dashboard. It connects to Trello’s API using the credentials you set up in Nappai, so you can automate comment management as part of larger workflows.

How it Works

When you use the component, Nappai sends a request to Trello’s REST API.

  • Create sends a POST request to add a new comment.
  • Read All fetches all comments on a card with a GET request.
  • Update sends a PUT request to change an existing comment.
  • Delete sends a DELETE request to remove a comment.

The component runs asynchronously, so it won’t block other parts of your workflow while waiting for Trello’s response.

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 comment to a Trello card.
  • Read All: Retrieve all comments from a Trello card.
  • Update: Modify the text of an existing comment.
  • Delete: Remove a comment from a Trello card.

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 All, Update, Delete

  • Card ID: The unique identifier of the Trello card you want to comment on.

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

  • Comment Body: The text you want to add or update.

    • Visible in: Create, Update

  • Comment ID: The unique identifier of the comment you want to update or delete.

    • Visible in: Update, Delete

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

    • Visible in: Create, 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 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 All, Update, Delete

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

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

Credential
This component requires a Trello Task API credential.

  1. In the Nappai credentials section, create a new credential of type “Trello Task API”.
  2. Provide the Trello OAuth token and Trello API key when prompted.
  3. In the component, select this credential from the “Credential” dropdown.

The credential fields (OAuth token and API key) are not shown in the Input Fields list because they are handled by the credential system.

Outputs

  • Data: Returns the result of the selected operation. For “Read All”, it returns a list of comment objects; for “Create”, “Update”, and “Delete”, it returns a single object indicating success or the created/updated comment.
  • Tool: When the component is used as a tool, this output provides the tool interface that an agent can call.

Usage Example

Scenario: Adding a comment to a card

  1. Drag the Trello Comment Component onto the canvas.
  2. Set Operation to Create.
  3. Enter the Card ID of the card you want to comment on.
  4. Type the comment text into Comment Body.
  5. Select the Trello Task API credential you created earlier.
  6. Connect the Data output to the next component in your workflow (e.g., a notification component).

Scenario: Updating a comment

  1. Set Operation to Update.
  2. Provide the Card ID and the Comment ID of the comment you want to change.
  3. Enter the new text in Comment Body.
  4. Run the workflow; the comment will be updated and the updated comment data will be available in the Data output.
  • Trello Card Component – Manage Trello cards (create, update, delete).
  • Trello List Component – Manage Trello lists (create, update, delete).

These components can be combined to build full Trello automation flows.

Tips and Best Practices

  • Use Mapping Mode when you need to add comments to many cards at once; connect a list of card IDs to the component.
  • Keep your Trello API key and OAuth token secure; store them in Nappai credentials rather than hard‑coding them.
  • When reading comments, consider filtering the results in a subsequent component to keep only the information you need.
  • Test each operation separately before chaining them together to ensure your workflow behaves as expected.

Security Considerations

  • Trello credentials are stored in Nappai’s secure credential store.
  • Never expose the OAuth token or API key in logs or public outputs.
  • Use the component’s built‑in credential selection to avoid accidental credential leaks.