Datto RMM

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

Actions53

Overview

The "Get Sites" operation under the "Account" resource in this node interacts with the Datto RMM API to retrieve information about sites managed within an account. It supports fetching either all sites automatically via pagination or a specific page of results with a defined maximum number of entries per page. Additionally, it allows filtering sites by partial site name matches and selecting which fields to include in the response.

This operation is useful for IT administrators or managed service providers who want to programmatically access and manage their site data from Datto RMM within automated workflows. For example, you could use this node to:

  • Retrieve a complete list of all sites to generate reports or dashboards.
  • Filter sites by name to focus on specific locations or clients.
  • Customize the returned data fields to optimize performance or integrate with other systems.

Properties

Name Meaning
Retrieve All Whether to automatically retrieve all site results using pagination (true), or manually specify page and max results (false).
Page The page number to retrieve when not retrieving all results automatically. (1-based index)
Max Results Maximum number of site results to return per page when not retrieving all automatically.
Site Name Filter A string filter to match site names partially; only sites containing this substring will be returned.
Fields to Include Select which fields to include in the response. Options allow adding all fields or defining specific ones to tailor the output.

Output

The node outputs JSON data representing the retrieved sites. Each item in the output corresponds to a site object with properties depending on the selected fields. Typical fields may include site identifiers, names, device counts, descriptions, and other metadata related to each site.

If binary data were involved (not indicated here), it would represent attachments or files associated with sites, but this operation focuses solely on JSON data.

Dependencies

  • Requires an active connection to the Datto RMM API, authenticated via an API key credential configured in n8n.
  • The base URL for the API is taken from the credential configuration.
  • No additional external dependencies are required beyond the API access.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Network connectivity problems can prevent reaching the Datto RMM API.
    • Using filters that do not match any sites will result in empty outputs.
    • Requesting pages beyond available data returns empty results.

  • Error Messages:

    • Authentication errors typically indicate invalid or expired API keys; verify and update credentials.
    • Rate limiting or quota exceeded errors require checking API usage limits.
    • Invalid parameter errors suggest incorrect property values (e.g., negative page numbers).

Resolving these usually involves verifying credentials, network status, and input parameters.

Links and References

Discussion