Planka icon

Planka

Interact with Planka API

Overview

The "💬 Create Comment on Card" operation for the 📝 CARD resource in this n8n node allows you to add a new comment to an existing card in Planka, a project management tool. This is useful for automating team communication, logging updates, or programmatically adding notes to cards as part of your workflow.

Common scenarios:

  • Automatically posting status updates or feedback to a card when certain events occur.
  • Logging automated test results or deployment notes directly onto relevant task cards.
  • Integrating external systems (e.g., support tickets, monitoring alerts) by adding contextual comments to cards.

Example:
When a support ticket is escalated, automatically add a comment to the related Planka card with the ticket details.


Properties

Name Type Meaning
Card ID String The unique identifier of the card to which the comment will be added.
Comment Text String The text content of the comment to be posted on the card.

Output

The output will be a JSON object representing the newly created comment action on the card. While the exact structure depends on the Planka API response, it typically includes fields such as:

{
  "id": "string",           // Unique identifier for the comment action
  "cardId": "string",       // ID of the card the comment was added to
  "text": "string",         // The comment text
  "createdAt": "string",    // Timestamp of creation
  "userId": "string",       // ID of the user who made the comment
  // ...other metadata fields
}

No binary data is produced by this operation.


Dependencies

  • Planka API: Requires access to a running Planka instance.
  • API Credentials: You must configure the plankaApi credentials in n8n for authentication.
  • n8n Configuration: Ensure the node has network access to the Planka server.

Troubleshooting

Common issues:

  • Invalid Card ID: If the provided Card ID does not exist, the API will return an error. Double-check the Card ID.
  • Missing Required Fields: Both Card ID and Comment Text are required. Omitting either will result in an error.
  • Authentication Errors: Incorrect or missing API credentials will cause authentication failures.
  • Permission Denied: The authenticated user may lack permission to comment on the specified card.

Error messages:

  • "Card not found": The Card ID is invalid or does not exist.
  • "Unauthorized" or "Forbidden": Check your API credentials and user permissions.
  • "Missing parameter: commentText": The Comment Text field is empty or missing.

How to resolve:

  • Verify all input fields are filled correctly.
  • Ensure your n8n credentials for Planka are valid and have sufficient permissions.
  • Confirm network connectivity between n8n and your Planka instance.

Links and References


Discussion