AvantGuard - NinjaOne icon

AvantGuard - NinjaOne

AvantGuard - NinjaOne

Actions159

Overview

This node integrates with the AvantGuard NinjaOne API to create a comment on a specified ticket within a ticketing system. It is useful for automating the process of adding notes, updates, or additional information to support tickets or service requests. For example, a user can automatically append status updates or troubleshooting details to a ticket as part of a workflow, improving communication and record-keeping.

Properties

Name Meaning
Ticket Id The unique identifier of the ticket where the comment will be added.
Additional Body Fields Optional fields to customize the comment, including:
- Comment: JSON object defining the comment content, such as whether it is public, the body text, HTML formatted body, and time tracked (in minutes). Example: {"public": true, "body": "new comment", "htmlBody": "<p>new comment</p>", "timeTracked": 60}
- Files: JSON array representing files to attach to the comment.

Output

The node outputs JSON data representing the response from the API after creating the comment. This typically includes details about the newly created comment such as its ID, content, timestamps, and any metadata returned by the ticketing system. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard NinjaOne API.
  • The base URL for the API must be configured in the node credentials.
  • The node uses the @avantguardllc/n8n-openapi-node package and an OpenAPI specification (openapi.json) bundled internally to define its operations.

Troubleshooting

  • Common issues:

    • Invalid or missing Ticket Id: Ensure the ticket ID provided exists and is correct.
    • Malformed JSON in the "Comment" or "Files" fields: Validate JSON syntax before input.
    • Authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
    • Network or API endpoint errors: Check connectivity and that the base URL is correct.
  • Error messages:

    • Unauthorized or 401 errors indicate authentication failure; recheck API credentials.
    • 404 errors may mean the ticket ID does not exist.
    • Validation errors from the API may occur if required comment fields are missing or incorrectly formatted.

Links and References

Discussion