Syncro RMM icon

Syncro RMM

Work with the Syncro RMM API
Join our community

Actions19

Overview

This node integrates with the Syncro RMM API to retrieve multiple contact records. It is designed to fetch either all contacts or a limited subset based on user-defined filters and limits. This functionality is useful in scenarios where you need to synchronize contact data, generate reports, or automate workflows involving customer contacts managed within Syncro RMM.

For example, you might use this node to:

  • Retrieve all contacts associated with a specific customer ID.
  • Fetch a limited number of recent contacts for quick processing.
  • Filter contacts dynamically to integrate with other systems or trigger notifications.

Properties

Name Meaning
Return All Whether to return all matching contacts or only up to a specified limit (true/false).
Limit The maximum number of contacts to return when "Return All" is false. Minimum value is 1.
Filters Collection of filters to narrow down the contacts returned. Currently supports:
   Customer ID Filter contacts by a specific Customer ID string.

Output

The node outputs an array of contact objects in the json field of each item. Each object represents a contact record retrieved from Syncro RMM, containing fields such as contact details and metadata as provided by the API.

No binary data output is indicated by the source code.

Dependencies

  • Requires an active connection to the Syncro RMM API.
  • Needs an API key credential configured in n8n with appropriate permissions to access contact data.
  • The base URL for API requests is dynamically constructed using the user's Syncro RMM subdomain.

Troubleshooting

  • Invalid API Key: If the API key is incorrect or expired, the node will fail authentication. Ensure the API key credential is valid and has necessary permissions.
  • Limit Exceeded or No Data Returned: Setting a very low limit may result in fewer contacts than expected. Conversely, requesting all contacts without filters could lead to large data sets and potential timeouts.
  • Filter Misconfiguration: Providing an invalid or empty Customer ID filter may result in no contacts being returned. Verify filter values before execution.

Links and References

Discussion