Cloodo CRM icon

Cloodo CRM

Get data from Cloodo API

Overview

The node integrates with the Cloodo CRM API to retrieve multiple notes. Specifically, the "Note" resource with the "Get Many" operation fetches a paginated list of notes from the system. This is useful for scenarios where users want to display or process multiple notes at once, such as generating reports, syncing notes with other systems, or displaying recent notes in dashboards.

Practical examples:

  • Fetching the latest 25 notes created within a specific date range.
  • Searching notes containing certain keywords.
  • Paginating through all notes to export them or analyze trends over time.

Properties

Name Meaning
Page The page number of results to retrieve (pagination). Defaults to 1.
Additional Fields A collection of optional parameters to refine the query:
- Limit Number of notes to return per page. Options: 10, 25, 50. Default is 10.
- Search A string to search notes by content or metadata.
- From Date Start date filter to get notes created on or after this date (format expected by API).
- To Date End date filter to get notes created on or before this date (format expected by API).

Output

The node outputs JSON data representing an array of note objects retrieved from the Cloodo CRM API. Each note object typically contains fields such as note content, creation date, author, and any associated metadata defined by the API.

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 focuses on JSON note data only.

Dependencies

  • Requires an active connection to the Cloodo CRM API.
  • Needs an API authentication token or key configured in n8n credentials (referred generically as "an API key credential").
  • The base URL for API requests is https://erp-amz.cloodo.com/v4/.
  • The node sends requests with headers specifying JSON content type and acceptance.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Incorrect date formats in "From Date" or "To Date" may result in API errors or empty responses.
    • Requesting pages beyond available data returns empty arrays.
    • Using unsupported limit values might default to API defaults or cause errors.
  • Error messages:

    • Authentication failures: Check that the API key credential is correctly set up and valid.
    • Validation errors on query parameters: Ensure dates are in correct format and limits are among allowed options.
    • Network errors: Verify network connectivity and API endpoint availability.

Links and References

  • Cloodo CRM API Documentation (assumed base URL; consult official docs for detailed endpoints)
  • n8n documentation on HTTP Request Node for understanding API integrations
  • General best practices for pagination and filtering in REST APIs

Discussion