Planka

Overview

The Create Board operation for the 📋 BOARD resource in this n8n node allows you to create a new board within a specified project in Planka, an open-source project management tool. This is useful for automating the setup of new boards as part of your workflow, such as when onboarding new projects or teams, or integrating with other systems that trigger the creation of project boards.

Practical examples:

• Automatically create a new board when a new project is started in your CRM.
• Set up default boards for each client or department as part of an onboarding process.
• Integrate with ticketing systems to generate boards for tracking issues or tasks.

Properties

Output

The output will be a JSON object representing the newly created board. The structure typically includes details such as:

{
  "id": "string",
  "name": "string",
  "position": number,
  "projectId": "string",
  // ...other board properties as returned by the Planka API
}

• Each output item will have its data under the json field.
• If multiple items are processed, the output will be an array of such objects.

Dependencies

• External Service: Requires access to a running Planka instance with API enabled.
• Authentication: Needs valid Planka API credentials configured in n8n under the credential type plankaApi.
• n8n Configuration: No special environment variables required beyond standard credential setup.

Troubleshooting

Common Issues:

• Invalid Project ID: If the provided Project ID does not exist, the API will return an error.
• Missing Required Fields: Omitting required fields like Name or Project ID will result in validation errors.
• Permission Denied: The API credentials used must have permission to create boards in the target project.

Error Messages and Resolutions:

• "Project not found": Check that the Project ID is correct and exists in Planka.
• "Missing required parameter: name": Ensure the Name property is filled in.
• "Unauthorized": Verify that the API credentials are correct and have sufficient permissions.

If the node is set to "Continue On Fail," errors will be output as:

{ "error": "Error message here" }

Otherwise, the workflow will stop on error.

Links and References

• Planka GitHub Repository
• n8n Documentation: Custom Nodes
• Planka API Reference (if available)