Cloodo Project icon

Cloodo Project

Get data from Cloodo Worksuite API

Actions26

Overview

The node integrates with the Cloodo Worksuite API to create new projects within the system. It allows users to specify essential project details such as the project name, start date, status, and optionally additional metadata like deadlines, client information, categories, members, and custom fields.

This node is beneficial in scenarios where project management workflows need automation, such as:

  • Automatically creating projects from form submissions or other triggers.
  • Syncing projects from external systems into Cloodo Worksuite.
  • Setting up projects programmatically with predefined statuses and timelines.

For example, a marketing team could use this node to automatically create new campaign projects when a new lead is qualified, setting the start date and assigning team members accordingly.

Properties

Name Meaning
Project Name The name/title of the project to be created.
Start Date The starting date and time for the project.
Status Current status of the project. Options: Canceled, Finished, In Progress, Not Started, On Hold, Under Review.
Format Date The format in which dates are represented. Currently supports "Y-M-D" (e.g., 2022-11-11).
Member IDs JSON array of user/member IDs to associate with the project (e.g., [123,456]).
Additional Fields A collection of optional fields including:
- Custom Fields Data: JSON string for custom field values.
- Deadline: Project deadline date/time.
- Client ID: JSON value representing the client associated.
- Category ID: String identifier for the project category.
- Member ID: Single member ID as a string.

Output

The node outputs JSON data representing the newly created project as returned by the Cloodo Worksuite API. This typically includes the project ID, name, status, dates, assigned members, and any additional metadata set during creation.

If binary data were involved (not indicated here), it would represent file attachments or similar resources related to the project, but this node focuses on JSON project data only.

Dependencies

  • Requires an active connection to the Cloodo Worksuite API endpoint at https://erp-amz.cloodo.com/v4.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The node uses JSON parsing for some input fields (e.g., member IDs, custom fields), so inputs must be valid JSON strings where applicable.

Troubleshooting

  • Invalid JSON Input: If member IDs or custom fields are not valid JSON strings, the node will fail to parse them. Ensure these inputs are correctly formatted JSON arrays or objects.
  • Authentication Errors: Missing or incorrect API credentials will cause authorization failures. Verify that the API key/token is correctly set up in n8n credentials.
  • Date Format Issues: Dates must conform to the specified format (y-MM-dd). Incorrectly formatted dates may result in API errors.
  • Missing Required Fields: The project name and start date are mandatory. Omitting these will cause the API to reject the request.
  • API Endpoint Unreachable: Network issues or incorrect base URL configuration can prevent communication with the Cloodo API.

Links and References

Discussion