Actions53
- Account Actions
- Device Actions
- Site Actions
- Alert Actions
- Job Actions
- Audit Actions
- System Actions
- Filter Actions
Overview
The node interacts with the Datto RMM API to manage devices, including setting user-defined fields (UDFs) on a specific device. The "Set UDF Fields" operation for the Device resource allows users to update custom metadata fields associated with a device in Datto RMM. This is useful for adding or modifying additional information about devices that is not covered by default properties.
Common scenarios include:
- Tagging devices with custom identifiers or notes.
- Storing extra configuration or status details relevant to your organization.
- Automating updates of device metadata based on external workflows or monitoring results.
For example, you might set "UDF 1" to a warranty expiration date or "UDF 3" to a location code.
Properties
| Name | Meaning |
|---|---|
| Device | Select the target device from a list of available devices to update its UDF fields. |
| UDF Fields | Specify one or more user-defined fields to set on the device. Options for field names: - UDF 1 - UDF 2 - UDF 3 - UDF 4 - UDF 5 For each selected field, provide the string value to assign. |
Output
The node outputs JSON data representing the result of the API call to update the device's UDF fields. Typically, this includes confirmation of the updated fields and their new values as stored in Datto RMM.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Datto RMM API via an API key credential configured in n8n.
- The node uses the Datto RMM API endpoint to fetch devices and update device data.
- Proper permissions on the API key are necessary to modify device information.
Troubleshooting
- Device Not Found: If the selected device UID is invalid or the device no longer exists, the API will return an error. Verify the device selection and refresh the device list.
- Invalid Field Names or Values: Only the predefined UDF fields (udf1 to udf5) can be set. Ensure the field names match these exactly and values are valid strings.
- API Authentication Errors: Check that the API key credential is correctly configured and has sufficient permissions.
- Network Issues: Connectivity problems to the Datto RMM API endpoint will cause failures. Confirm network access and API URL correctness.
Links and References
- Datto RMM API Documentation (for detailed API usage and UDF field specifications)
- n8n Documentation on Creating Custom Nodes