Plane icon

Plane

Consume Plane API

Overview

This node integrates with the Plane API to manage projects and related entities. Specifically, for the Project - Create operation, it allows users to create a new project by specifying essential details such as the project's name and identifier, along with optional additional fields like description and network visibility.

Common scenarios where this node is beneficial include:

  • Automating project creation workflows in software development or task management pipelines.
  • Integrating Plane project management into broader automation systems.
  • Quickly provisioning new projects with predefined settings from other tools or triggers.

Practical example:

  • Automatically create a new project in Plane when a new client onboarding form is submitted, setting the project name, unique identifier, and optionally marking it as public or private.

Properties

Name Meaning
Name The name of the project to be created.
Identifier A unique key or identifier for the project (e.g., "PROJ").
Additional Fields Optional extra settings for the project:
- Description: Text describing the project.
- Network: Visibility setting, either "Public" or "Private".

Output

The output JSON contains the full response from the Plane API after creating the project. This typically includes all details of the newly created project such as its ID, name, identifier, description, network visibility, and any other metadata returned by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires an active Plane API connection configured in n8n with appropriate API credentials.
  • The node uses internal helper functions to make HTTP requests to the Plane API endpoints.
  • No additional external services are required specifically for the Project Create operation.

Troubleshooting

  • Missing Required Fields: If "Name" or "Identifier" is not provided, the API will likely reject the request. Ensure these mandatory fields are set.
  • API Authentication Errors: Verify that the Plane API credentials are correctly configured and have permissions to create projects.
  • Network Field Values: The "Network" field accepts only specific values (Public = 2, Private = 0). Providing invalid values may cause errors.
  • API Rate Limits or Connectivity Issues: Network problems or rate limiting by the Plane API can cause failures; check connectivity and API usage limits.
  • Error Messages: Errors thrown by the node will contain messages from the Plane API. Review these messages to identify issues such as duplicate identifiers or invalid parameters.

Links and References

Discussion