Coolify icon

Coolify

Interact with Coolify API
Join our community

Actions36

Overview

This node integrates with the Coolify API to manage various resources including projects. Specifically, for the Project - Create operation, it allows users to create a new project within the Coolify platform by specifying essential details such as the project name and optional additional fields like description, team association, and labels.

Typical use cases include automating project setup workflows in development pipelines, organizing infrastructure or application projects programmatically, and integrating project creation into larger automation scenarios where new projects need to be provisioned dynamically.

For example, a user might automate creating a new project whenever a new client onboarding process starts, ensuring consistent naming conventions and metadata tagging without manual input.

Properties

Name Meaning
Name The name of the project to be created. This is a required field.
Additional Fields Optional extra information about the project:
- Description A textual description providing more details about the project.
- Team ID Identifier of the team to which this project belongs.
- Labels One or more labels (tags) used to organize and categorize projects.

Output

The node outputs an array of JSON objects representing the created project(s). Each object contains the data returned by the Coolify API after successfully creating a project, typically including the project's unique identifier, name, description, associated team, labels, and other metadata.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Coolify API.
  • The node needs an API authentication token credential configured in n8n to authorize requests to the Coolify service.
  • Network access to the Coolify API endpoint must be available from the n8n environment.

Troubleshooting

  • Common issues:
    • Missing or invalid API credentials will cause authentication failures.
    • Providing an empty or missing project name will likely result in validation errors.
    • Incorrect team IDs or labels that do not exist in Coolify may cause the API to reject the request.
  • Error messages:
    • "The resource "project" is not implemented!" indicates a misconfiguration or unsupported resource selection.
    • "The operation "create" is not implemented!" suggests the operation name is incorrect or not supported.
    • API error responses related to authorization or validation should be checked in the node's execution logs and corrected accordingly.

Links and References

Discussion