NinjaOneInstall

Overview

This node interacts with the NinjaOne API to retrieve information about end users within a specified organization. Specifically, the "Get End Users" operation under the "Organization" resource fetches a list of end users associated with an organization by its ID. It optionally includes detailed role information for each user.

This node is useful in scenarios where you need to automate workflows involving user management or reporting within an organization's IT environment managed by NinjaOne. For example, you might use it to generate reports on user roles, synchronize user data with other systems, or trigger alerts based on user attributes.

Properties

Output

The node outputs an array of JSON objects representing the end users retrieved from the NinjaOne API for the specified organization. Each object contains user details as returned by the API, including user attributes and, if requested, their role information.

The output structure corresponds directly to the API response JSON. No binary data output is produced by this operation.

Example output snippet (conceptual):

[
  {
    "id": 123,
    "name": "John Doe",
    "email": "john.doe@example.com",
    "roles": [
      {
        "roleId": 1,
        "roleName": "Administrator"
      }
    ]
  },
  ...
]

Dependencies

• Requires an active NinjaOne API OAuth2 credential configured in n8n.
• The node uses the NinjaOne REST API endpoints, so network access to NinjaOne's API service is necessary.
• No additional external dependencies beyond the NinjaOne API and n8n's HTTP request capabilities.

Troubleshooting

• Missing or invalid organization Id: Ensure the "Id" property is set correctly and corresponds to a valid organization in NinjaOne.
• API authentication errors: Verify that the NinjaOne API credentials are properly configured and have sufficient permissions.
• No end users returned: Confirm that the organization has end users assigned; otherwise, the response will be empty.
• Include Roles flag not working: If role information is missing despite setting "Include Roles" to true, check API permission scopes and whether roles exist for users.
• Binary data errors: Not applicable for this operation since it does not handle binary data.

Links and References

• NinjaOne API Documentation (general reference for API endpoints)
• n8n Documentation - Creating Custom Nodes