Datto RMM

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

Actions53

Overview

This node interacts with the Datto RMM API to retrieve audit information based on a device's MAC address. Specifically, the "Get Audit by MAC Address" operation fetches detailed audit data related to a device identified by its MAC address. This can include device audit details, software inventory audits, or hardware configuration audits.

Common scenarios where this node is beneficial include:

  • IT administrators wanting to quickly pull audit reports for a specific device using its MAC address.
  • Automated workflows that verify device compliance or inventory status by fetching audit data.
  • Integration with asset management systems to enrich device records with audit information.

Practical example:

  • An automation that triggers when a new device is detected and uses this node to fetch its latest audit report by MAC address to update the CMDB (Configuration Management Database).

Properties

Name Meaning
MAC Address The MAC address of the device in a 12-character format without separators (e.g., AABBCCDDEEFF).
Audit Type The type of audit information to retrieve. Options: Device (complete device audit), Software (software inventory audit), Hardware (hardware configuration audit).
Include Archived Boolean flag indicating whether to include archived or historical audit data in the response.
Fields to Include Select which fields to include in the response. Allows defining specific audit data fields to be returned.

Output

The node outputs JSON data containing the requested audit information for the specified MAC address. The structure depends on the selected audit type:

  • Device audit: Detailed device audit information including current state and configurations.
  • Software audit: Inventory of installed software on the device.
  • Hardware audit: Hardware configuration details of the device.

If "Include Archived" is enabled, the output may also contain historical audit records.

The node does not output binary data; all results are structured JSON objects representing audit data.

Dependencies

  • Requires an active connection to the Datto RMM API via an API key credential configured in n8n.
  • The node relies on the Datto RMM API endpoint to fetch audit data by MAC address.
  • Proper API URL and authentication credentials must be set up in the node's credential configuration.

Troubleshooting

  • Invalid MAC Address Format: Ensure the MAC address is exactly 12 hexadecimal characters with no separators. Errors may occur if the format is incorrect.
  • No Audit Data Found: If the MAC address does not correspond to any device in Datto RMM, the node may return empty results or errors. Verify the MAC address exists in the system.
  • API Authentication Errors: Check that the API key credential is valid and has sufficient permissions to access audit data.
  • Network or API Endpoint Issues: Confirm network connectivity and that the Datto RMM API URL is correct and reachable.
  • Field Selection Issues: If custom fields are selected but do not exist or are misspelled, the response may omit those fields or cause errors.

Links and References

Discussion