NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Management → Create Custom Fields Policy Condition

AI-generated

Overview

This node integrates with the NinjaOne API to manage policy conditions related to custom fields within the Management resource. Specifically, the "Create Custom Fields Policy Condition" operation allows users to create a new condition for a given policy by specifying various parameters such as severity, priority, notification settings, and matching criteria.

Use cases include automating the creation of policy conditions that trigger alerts or actions based on custom field values in your managed environment. For example, you might create a condition that triggers a critical alert when a custom field meets certain criteria, enabling proactive incident management.

Properties

Name Meaning
Policy Id The unique identifier of the policy to which the custom fields condition will be added.
Enabled Boolean flag indicating whether the policy condition is active (true) or inactive (false).
Display Name A descriptive name for the policy condition to identify it easily.
Severity The severity level of the policy condition. Options: NONE, MINOR, MODERATE, MAJOR, CRITICAL.
Priority The priority level of the policy condition. Options: NONE, LOW, MEDIUM, HIGH.
Channels JSON array defining notification channels for the policy condition.
Scripts JSON array defining scripts associated with the policy condition, including execution context and variables.
Notification Action Defines the notification action to take. Options: NONE, SEND.
Notify On Reset Boolean flag indicating if notifications should be sent when the condition resets.
Reset Threshold Number representing the reset threshold in seconds for the policy condition.
Match All JSON array of conditions where all must be met by the custom field value.
Match Any JSON array of conditions where any one must be met by the custom field value.

Output

The node outputs an array of JSON objects representing the response from the NinjaOne API after creating the custom fields policy condition. Each output item contains the full JSON response returned by the API, which typically includes details about the newly created condition such as its ID, status, and configuration.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential configured in n8n for authenticating requests to the NinjaOne API.
  • The node uses OAuth2 authentication under the generic term "an API key credential".
  • Network access to the NinjaOne API endpoints is necessary.

Troubleshooting

  • Missing or invalid Policy Id: Ensure the Policy Id property is set correctly and corresponds to an existing policy in NinjaOne.
  • Invalid JSON in Channels, Scripts, Match All, or Match Any: These properties expect valid JSON arrays. Invalid JSON syntax will cause errors. Validate JSON formatting before use.
  • Binary Data Errors: Not applicable for this operation since it does not handle binary data.
  • API Authentication Failures: Verify that the API key credential is properly configured and has sufficient permissions.
  • Error Messages:
    • "No binary data exists on item!" or "No binary data property ... does not exist on item!" — Not relevant here but may appear if other operations expecting binary data are used incorrectly.
    • General API errors will be returned in the JSON output under an error message if "Continue On Fail" is enabled.

Links and References

Discussion