Datto RMM

Interact with Datto RMM API to manage devices, sites, alerts, and monitoring

Actions53

Overview

The node interacts with the Datto RMM API to manage and retrieve information about various resources, including Sites. Specifically, for the Site - Get Many operation, it fetches multiple site records from the Datto RMM platform. This operation supports pagination and filtering by site name, allowing users to either retrieve all sites automatically or specify page numbers and maximum results per page.

This node is beneficial in scenarios where you need to:

  • List all managed sites within your Datto RMM environment.
  • Filter sites by partial name matches to find specific locations or groups.
  • Integrate site data into workflows for reporting, monitoring, or automation purposes.

For example, an MSP could use this node to pull a list of all client sites to generate a consolidated status report or trigger alerts based on site-specific conditions.

Properties

Name Meaning
Retrieve All Whether to automatically retrieve all site records using pagination (true), or manually specify page and max results (false).
Page The page number to retrieve when not retrieving all results automatically.
Max Results The maximum number of site records to return per page when not retrieving all results automatically.
Site Name Filter A string to filter sites by name; partial matches are allowed.
Fields to Return Select which fields of the site resource to include in the response.

Output

The output contains a JSON array of site objects matching the query parameters. Each site object includes the fields selected via the "Fields to Return" property. Typical fields might include site identifiers, names, device counts, and other metadata relevant to each site.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Datto RMM API.
  • The node uses the base URL configured in the credentials to make REST API calls.
  • Pagination support depends on the API's ability to return paged results.
  • No additional external dependencies beyond the Datto RMM API and n8n core modules.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Specifying invalid page numbers or max results may result in empty responses or errors.
    • Filtering by site name with no matches returns an empty array.

  • Error Messages:

    • Authentication errors typically indicate invalid or expired API keys; verify and update credentials.
    • API rate limits may cause request failures; consider adding delays or reducing request frequency.
    • If the node throws "Resource site is not supported yet," ensure the node version is up to date as this resource is implemented.

Links and References

Discussion