Planka

Overview

The Add Manager to Project operation in the Planka n8n node allows you to assign a user as a manager (administrator) to a specific project within your Planka instance. This is useful for automating team management, onboarding workflows, or synchronizing permissions between systems. For example, when a new project is created and a user needs to be granted administrative rights automatically, this node operation can handle that step.

Practical scenarios:

• Automatically assigning a project lead as manager when a new project is created.
• Integrating HR or onboarding tools to ensure the right users have admin access to relevant projects.
• Managing project roles from external systems via workflow automation.

Properties

Output

The output will be a JSON object representing the result of the API call to add a manager to the specified project. The exact structure depends on the Planka API response, but typically it will include details about the newly created project manager relationship, such as IDs and possibly user/project information.

Example output structure:

{
  "id": "managerRelationshipId",
  "projectId": "projectId",
  "userId": "userId",
  // ...other fields as returned by Planka API
}

If an error occurs and "Continue On Fail" is enabled, the output will be:

{
  "error": "Error message"
}

Dependencies

• Planka API: Requires access to a running Planka instance with API enabled.
• API Credentials: You must configure the plankaApi credentials in n8n for authentication.

Troubleshooting

Common issues:

• Invalid Project ID or User ID: If either ID does not exist, the API will return an error.
• Insufficient Permissions: The API credentials used must have permission to manage project roles.
• Network/Connection Errors: Ensure n8n can reach your Planka instance.

Error messages:

• "Project not found": Check the Project ID.
• "User not found": Check the User ID.
• "Unauthorized": Verify your API credentials and permissions.
• "An unknown error occurred": A generic fallback if the error is not an instance of Error.

Links and References

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