Actions158
- System Actions
- Organization Actions
- Devices Actions
- Get Device
- Get Device Active Jobs
- Get Device Activities
- Get Device Alerts
- Get Device Disk Drives
- Get Device Installed OS Patches
- Get Device Installed Software Patches
- Get Device Last Logged On User
- Get Device Network Interfaces
- Get Device Pending Failed Rejected OS Patches
- Get Device Pending Failed Rejected Software Patches
- Get Device Processors
- Get Device Services
- Get Device Software
- Get Device Volumes
- Get Node Custom Fields
- Update Node Attribute Values
- Get Policy Overrides
- Groups Actions
- Queries Actions
- Get Antivirus Status Report
- Get Antivirus Threats
- Get Computer Systems
- Get Custom Fields Detailed Report
- Get Custom Fields Report
- Get Device Health Report
- Get Device Usage
- Get Disk Drives
- Get Installed OS Patches
- Get Installed Software Patches
- Get Last Logged On Users Report
- Get Network Interfaces
- Get Operating Systems
- Get Pending Failed Rejected OS Patches
- Get Pending Failed Rejected Software Patches
- Get Policy Overrides 1
- Get Processors
- Get RAID Controller Report
- Get RAID Drive Report
- Get Scoped Custom Fields Detailed Report
- Get Scoped Custom Fields Report
- Get Software
- Get Volumes
- Get Windows Services Report
- Management Actions
- Get Custom Fields Policy Conditions
- Create Custom Fields Policy Condition
- Get Windows Event Policy Conditions
- Create Windows Event Policy Condition
- Delete Policy Condition
- Get Custom Fields Policy Condition
- Get Windows Event Policy Condition
- Create Organization
- Node Approval Operation
- Reset Alert
- Reset Alert Set Activity Data
- Update Device Maintenance
- Cancel Device Maintenance
- Control Windows Service
- Update Device
- Get Device Link
- Reset Policy Overrides
- Reboot Devices
- Remove Device Owner
- Request Scripting Options
- Run Script On Device
- Set Device Owner
- Set Windows Service Configuration
- Submit OS Patch Apply
- Submit OS Patch Scan
- Submit Software Patch Apply
- Submit Software Patch Scan
- Create Location For Organization
- Get Installer
- Get Installer For Location
- Update Organization
- Update Location
- Update Node Role Policy Assignment For Organization
- Create Policy
- Ticketing Actions
- Webhooks Actions
- Related Items Actions
- Location Actions
- Backup Actions
- Knowledge Base Articles Actions
- Upload Temp Attachments
- Download Knowledge Base Article
- Get Client Knowledge Base Articles
- Get Global Knowledge Base Articles
- Get Knowledge Base Article Signed Urls
- Get Knowledge Base Folder Content
- Get Knowledge Base Folder Path Content
- Download Related Item Attachment
- Get Related Item Attachments Signed Urls
- Organization Documents Actions
- Document Templates Actions
- Checklist Templates Actions
- Custom Fields Actions
- Organization Checklists Actions
Queries → Get Scoped Custom Fields Report
AI-generatedOverview
This node interacts with the NinjaOne API to retrieve a report of scoped custom fields. It is designed to fetch detailed information about custom fields that are defined within various scopes in the NinjaOne system. This operation is useful for users who want to audit, analyze, or synchronize custom field data from NinjaOne into their workflows.
Typical use cases include:
- Extracting updated custom field data after a certain date to keep external systems in sync.
- Paginating through large sets of custom fields using cursors and page size limits.
- Filtering the report by specific scopes or selecting particular fields to optimize data retrieval.
- Optionally retrieving secure values in plain text for further processing or reporting.
Properties
| Name | Meaning |
|---|---|
| Cursor | Cursor name used for pagination to continue fetching records from where the last request ended. |
| Page Size | Limit on the number of records returned per page (default 1000). |
| Updated After | Filter to return only custom fields updated after the specified date (ISO 8601 string). |
| Fields | Comma-separated list of specific fields to include in the response. |
| Scopes | Comma-separated list of scopes to filter the custom fields; default is "all" scopes. |
| Show Secure Values | Boolean flag indicating whether secure values should be returned as plain text (true/false). |
Output
The node outputs an array of JSON objects representing the scoped custom fields report retrieved from the NinjaOne API. Each item contains the data fields requested, filtered, and paginated according to the input parameters.
If secure values are included (when Show Secure Values is true), these will be presented in plain text rather than encrypted form.
No binary data output is produced by this operation.
Dependencies
- Requires an active NinjaOne API OAuth2 credential configured in n8n for authentication.
- The node uses NinjaOne's REST API endpoints under
/v2/queries/scoped-custom-fields-report(implied by the operation context). - No additional environment variables or external services are required beyond the NinjaOne API access.
Troubleshooting
Common issues:
- Invalid or expired API credentials will cause authentication failures.
- Providing an invalid cursor or page size may result in empty responses or errors.
- Incorrect date format in
Updated Aftercan lead to query failures. - Requesting fields or scopes that do not exist may return incomplete data or errors.
Error messages:
- Authentication errors typically indicate problems with the API key or OAuth token; re-authenticate or refresh credentials.
- Validation errors on query parameters suggest checking the format and allowed values for each property.
- Network or API downtime errors require retrying later or verifying NinjaOne service status.
Links and References
- NinjaOne API Documentation — Official API docs for reference on scoped custom fields and other endpoints.
- n8n OAuth2 Credential Setup — Guide on configuring OAuth2 credentials in n8n.
- Working with Pagination in APIs — General best practices for handling paginated API responses in n8n.