NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Webhooks → Configure Webhook

AI-generated

Overview

This node integrates with the NinjaOne API to configure webhooks for activity notifications. It allows users to set up a callback URL where NinjaOne will send event data based on specified activity filters. This is useful for automating workflows triggered by events in NinjaOne, such as device changes, alerts, or other monitored activities.

Typical use cases include:

  • Automatically triggering downstream processes when specific activities occur in NinjaOne.
  • Receiving real-time updates about monitored systems or policies.
  • Customizing webhook payloads by expanding references or adding custom HTTP headers.

Properties

Name Meaning
Url The callback (webhook) URL where activity notifications will be sent.
Activities JSON object specifying which activities to filter and receive notifications for.
Expand JSON array defining which references to expand in the webhook payloads for more detail.
Headers JSON object containing custom HTTP headers (e.g., Authorization) to include in requests.

Output

The node outputs an array of JSON objects representing the response from the NinjaOne API after configuring the webhook. Each output item contains a json field with the API response data confirming the webhook setup or providing details about the configured webhook.

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential for NinjaOne (OAuth2 or similar).
  • The node uses NinjaOne's REST API endpoints to configure webhooks.
  • No additional environment variables are explicitly required beyond the API credentials.

Troubleshooting

  • Missing or invalid URL: Ensure the "Url" property is a valid, reachable callback URL. Invalid URLs may cause webhook configuration failures.
  • Malformed JSON in Activities, Expand, or Headers: These properties expect valid JSON strings. Syntax errors will cause parsing failures.
  • Authentication errors: Verify that the provided API authentication token is valid and has sufficient permissions to configure webhooks.
  • No binary data error: Not applicable here since this operation does not handle binary data.
  • API request failures: Check network connectivity and NinjaOne API status if requests fail.

Links and References

Discussion