NinjaOne icon

NinjaOne

Interact with the NinjaOne API
Join our community

Actions30

Overview

The node interacts with the NinjaOne API to retrieve custom fields associated with a specific device. This operation is useful when you want to fetch additional metadata or user-defined attributes that have been assigned to a device within the NinjaOne platform. For example, an IT administrator might use this node to pull custom configuration details or asset tags for inventory management or reporting purposes.

Properties

Name Meaning
Device ID The unique identifier of the device whose custom fields you want to retrieve. This is a required string input.

Output

The node outputs JSON data containing the custom fields of the specified device. The structure typically includes key-value pairs representing each custom field and its value. This allows downstream nodes or workflows to process or analyze device-specific metadata.

If the node supports binary data output (not indicated here), it would represent files or attachments related to the device's custom fields, but in this case, the output is purely JSON-based.

Dependencies

  • Requires an active connection to the NinjaOne API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for the API can be customized via credentials; otherwise, it defaults to https://api.ninjaone.com.

Troubleshooting

  • Missing or invalid Device ID: Ensure the Device ID property is provided and correctly references an existing device in NinjaOne.
  • Authentication errors: Verify that the API key or OAuth2 credentials are valid and have sufficient permissions to access device data.
  • API connectivity issues: Check network connectivity and NinjaOne service status if requests fail.
  • Empty or unexpected response: Confirm that the device has custom fields defined; otherwise, the response may be empty.

Links and References

Discussion