Cloodo CRM icon

Cloodo CRM

Get data from Cloodo API

Overview

This node integrates with the Cloodo CRM API to retrieve milestone data related to projects. Specifically, for the "Project" resource and the "Milestones Project" operation, it fetches milestone information associated with a given project ID. This is useful in scenarios where users want to track project progress, deadlines, or deliverables by accessing milestone details programmatically within their workflows.

Practical examples include:

  • Automatically retrieving milestones of a project to update a project management dashboard.
  • Triggering notifications or follow-up tasks when certain milestones are reached or overdue.
  • Aggregating milestone data across multiple projects for reporting purposes.

Properties

Name Meaning
ID The unique identifier of the project whose milestones you want to retrieve.
Page The page number for paginated results when fetching multiple milestones (default is 1).
Additional Fields Optional parameters to refine the query:
- Limit Number of milestones to return per page. Options: 10, 25, 50.
- From Date Filter milestones starting from this date (format expected as string, e.g., YYYY-MM-DD).
- To Date Filter milestones up to this date (format expected as string, e.g., YYYY-MM-DD).

Output

The node outputs JSON data containing the milestone details retrieved from the Cloodo API. Each item in the output corresponds to a milestone associated with the specified project. Typical fields may include milestone identifiers, names, descriptions, start and end dates, status, and other relevant metadata.

If binary data were involved (e.g., attachments), it would be included in a separate binary property, but based on the provided code and properties, this node primarily deals with JSON data representing milestones.

Dependencies

  • Requires an active connection to the Cloodo CRM API.
  • Needs an API authentication token or key configured in n8n credentials to authorize requests.
  • The base URL for API requests is https://erp-amz.cloodo.com/v4/.
  • Proper network access to the Cloodo API endpoint must be ensured.

Troubleshooting

  • Invalid or missing project ID: If the ID property is empty or incorrect, the API will likely return an error or no data. Ensure the correct project ID is provided.
  • Authentication errors: If the API key or token is invalid or expired, the node will fail to authenticate. Verify and update credentials as needed.
  • Pagination issues: If many milestones exist, ensure the Page and Limit parameters are set appropriately to retrieve all data.
  • Date filter format: Incorrectly formatted From Date or To Date values may cause the API to reject the request or return unexpected results. Use proper date strings.
  • API downtime or network issues: Temporary unavailability of the Cloodo API or network problems can cause failures. Retry after some time or check connectivity.

Common error messages might include HTTP 401 Unauthorized (authentication failure), HTTP 400 Bad Request (invalid parameters), or HTTP 404 Not Found (invalid project ID).

Links and References

Discussion