NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

System → Get Alerts

AI-generated

Overview

This node interacts with the NinjaOne API to retrieve system alerts based on specified filters. It is useful for monitoring and managing alerts generated by various sources within an IT environment managed by NinjaOne. For example, you can use this node to fetch alerts filtered by their source type, device, language, or time zone, enabling automated workflows that respond to specific alert conditions.

Properties

Name Meaning
Source Type Filter alerts by their originating source type (e.g., hardware, software).
Df Filter alerts by a specific device identifier.
Lang Specify the language tag to localize alert information.
Tz Define the time zone context for alert timestamps.

Output

The node outputs an array of JSON objects, each representing an alert retrieved from the NinjaOne system. Each alert object contains details as provided by the NinjaOne API, such as alert metadata, source, device info, timestamps, and localized messages depending on the input parameters.

No binary data output is produced by this operation.

Dependencies

  • Requires an active NinjaOne API OAuth2 authentication credential configured in n8n.
  • The node uses NinjaOne's REST API endpoints to fetch alert data.
  • No additional external dependencies are required beyond the NinjaOne API access.

Troubleshooting

  • Common issues:

    • Missing or invalid API credentials will cause authentication failures.
    • Providing incorrect filter values (e.g., invalid device ID or unsupported source type) may result in empty responses or errors.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • Errors returned from the NinjaOne API will be surfaced in the node’s output if "Continue On Fail" is enabled.
    • Typical error messages include authentication errors, resource not found, or invalid query parameters.
  • Resolutions:

    • Verify that the NinjaOne API credentials are correctly set up and have sufficient permissions.
    • Double-check filter parameter values for correctness.
    • Ensure network access to the NinjaOne API endpoint is available.

Links and References

Discussion