Planka icon

Planka

Interact with Planka API

Overview

The Create Board List operation for the 📋 BOARD resource in this n8n node allows you to create a new list within an existing board in Planka, an open-source project management tool. This is useful for automating the organization of tasks or cards into lists (such as "To Do", "In Progress", "Done") on a board, streamlining workflows, and integrating Planka with other tools.

Practical scenarios:

  • Automatically creating standard workflow lists when a new board is created.
  • Integrating with external systems to generate lists based on incoming data or events.
  • Setting up templated boards for repeated processes or projects.

Properties

Name Type Meaning
Board ID String The unique identifier of the board where the new list will be created.
Name String The name/title of the new list to be added to the board.
Position Number The position/order of the new list within the board (default: 1).

Output

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

{
  "id": "string",
  "name": "string",
  "position": number,
  "color": "string",
  "boardId": "string",
  // ...other metadata fields
}
  • id: Unique identifier of the new list.
  • name: Name of the list.
  • position: Position/order of the list in the board.
  • color: Color assigned to the list (if applicable).
  • boardId: Identifier of the parent board.

Dependencies

  • Planka API: Requires access to a running Planka instance.
  • API Credentials: You must configure the plankaApi credentials in n8n for authentication.
  • n8n Configuration: No special environment variables are required beyond the API credentials.

Troubleshooting

Common issues:

  • Invalid Board ID: If the provided Board ID does not exist, the API will return an error.
  • Missing Required Fields: Omitting required properties like Board ID or Name will result in validation errors.
  • Authentication Errors: Incorrect or missing API credentials will cause authentication failures.

Error messages:

  • "Board not found": Check that the Board ID is correct and exists in your Planka instance.
  • "Missing required parameter: name": Ensure the Name property is provided.
  • "Unauthorized": Verify your Planka API credentials in n8n.

Links and References

Discussion