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 detailed information about devices managed within the Datto RMM platform. Specifically, the "Get by MAC Address" operation under the "Device" resource allows users to fetch device details by providing a device's MAC address. This is useful in scenarios where you have the MAC address of a device and want to obtain its associated metadata, status, or configuration from Datto RMM.

Practical examples include:

  • Automatically identifying a device in your network monitoring workflow by its MAC address.
  • Enriching asset management records with up-to-date device information.
  • Triggering alerts or automation based on device attributes retrieved via MAC address lookup.

Properties

Name Meaning
MAC Address The MAC address of the device to look up, formatted as 12 hexadecimal characters without separators (e.g., AABBCCDDEEFF). This is a required field.
Fields to Return Select which fields of the device record should be included in the response. This allows customizing the output to include only relevant data fields.

Output

The node outputs JSON data representing the device information retrieved from Datto RMM for the specified MAC address. The structure of this JSON depends on the selected fields in "Fields to Return," but typically includes device identifiers, status, type, IP addresses, hostname, and other metadata.

If binary data were involved (not indicated here), it would represent files or attachments related to the device, but this operation focuses solely on JSON device data.

Dependencies

  • Requires an active connection to the Datto RMM API using a valid API authentication token configured in the node credentials.
  • The node relies on the Datto RMM API endpoint configured in the credentials (apiUrl).
  • No additional external services are needed beyond the Datto RMM API.

Troubleshooting

  • Invalid MAC Address Format: Ensure the MAC address is exactly 12 hexadecimal characters with no separators. Incorrect formatting will likely cause the API request to fail or return no results.
  • No Device Found: If the MAC address does not correspond to any device in Datto RMM, the node may return an empty result or error. Verify the MAC address exists in the system.
  • API Authentication Errors: Check that the API key credential is correctly set up and has sufficient permissions to access device data.
  • Network Issues: Connectivity problems to the Datto RMM API endpoint can cause timeouts or failures. Confirm network access and correct API URL.
  • Field Selection Errors: Selecting invalid or unsupported fields in "Fields to Return" might cause errors or incomplete data. Use the provided field options to avoid this.

Links and References

Discussion