Plane

Overview

This node operation creates a new label within a specified project in the Plane API. Labels are used to categorize or tag issues, tasks, or other entities within a project management context. Creating labels helps organize work items by grouping them under meaningful tags such as "bug," "feature," or "urgent."

Common scenarios where this node is beneficial include:

• Automatically tagging newly created issues with specific labels based on workflow rules.
• Organizing project tasks by color-coded labels for better visual management.
• Adding hierarchical labels by specifying parent labels to create nested categorization.

Example: You want to add a green-colored label named "Frontend" to your project to mark all UI-related issues.

Properties

Name	Meaning
Project Name or ID	The identifier of the project where the label will be created. Choose from a list or use an expression.
Name	The name of the label to create.
Additional Fields	Optional extra properties for the label:
- Description	A textual description explaining the purpose or details of the label.
- Color	The color of the label represented as a hex code (default is green #00FF00).
- Parent ID	The ID of a parent label to create a hierarchical relationship (nested label).

Output

The output JSON contains the newly created label object returned from the Plane API. This typically includes fields such as the label's unique ID, name, description, color, and any parent-child relationships.

No binary data output is involved in this operation.

Dependencies

• Requires an active connection to the Plane API with appropriate authentication credentials (e.g., an API key).
• The node depends on the Plane API endpoints for projects and labels.
• The "Project Name or ID" property uses a dynamic options loader that fetches available projects via the Plane API.

Troubleshooting

• Missing or invalid Project ID: Ensure the project ID is correctly selected or provided. Using an invalid or empty project ID will cause the API request to fail.
• Label name conflicts: If a label with the same name already exists, the API may reject the creation or return an error. Use unique label names or handle errors accordingly.
• Invalid color format: The color must be a valid hex code (e.g., #FF0000). Invalid formats might cause the API to reject the request.
• Parent ID issues: Specifying a non-existent parent label ID will result in an error. Verify the parent label exists before assigning it.
• API connectivity problems: Network issues or incorrect API credentials will prevent successful label creation. Check credentials and network access.

Common error messages:

• "Project not found" — Verify the project ID.
• "Label with the same name already exists" — Use a different label name or update existing label instead.
• "Invalid color code" — Correct the color hex code format.

Links and References

• Plane API Documentation (general reference for API endpoints)
• n8n Expressions Documentation (for using expressions in input fields)