Actions53
- Account Actions
- Device Actions
- Site Actions
- Alert Actions
- Job Actions
- Audit Actions
- System Actions
- Filter Actions
Overview
The node interacts with the Datto RMM API to retrieve custom filters defined within an organization’s Datto RMM environment. Specifically, the "Get Custom Filters" operation fetches user-defined filter configurations that can be used to segment or organize monitoring data, alerts, devices, or other entities managed by Datto RMM.
This node is beneficial in scenarios where users want to programmatically access and utilize their custom filters for automation workflows, reporting, or integration with other systems. For example, a user might retrieve all active custom filters to apply them in a dashboard or trigger specific actions based on filtered device groups.
Properties
| Name | Meaning |
|---|---|
| Include Inactive | Whether to include inactive or disabled custom filters in the results (true/false). |
| Category | Filter category to narrow down the results. Options: All, Monitoring, Maintenance, Reporting, Automation, Custom. |
| Retrieve All | Whether to automatically retrieve all results using pagination (true) or manually specify page and max results (false). |
| Page | The page number to retrieve when not retrieving all results automatically (1-based index). |
| Max Results | Maximum number of results to return per page when not retrieving all automatically. |
| Fields to Include | Select which fields to include in the response. Can add all fields or define specific ones. |
Output
The output JSON contains an array of custom filter objects retrieved from the Datto RMM API. Each object typically includes properties such as:
uid: Unique identifier of the filter.name: Name of the custom filter.category: Category under which the filter is classified.- Other metadata fields depending on the selected fields in "Fields to Include".
No binary data is output by this node.
Dependencies
- Requires an API key credential configured in n8n to authenticate with the Datto RMM API.
- The node depends on the Datto RMM API being accessible at the configured base URL.
- Pagination support is built-in, but the user must configure pagination parameters if not retrieving all results automatically.
Troubleshooting
Common Issues:
- Authentication failures due to invalid or missing API credentials.
- Network connectivity issues preventing access to the Datto RMM API.
- Requesting pages beyond available data when manual pagination is used.
- Selecting fields that do not exist or are unsupported may result in incomplete data.
Error Messages:
- Errors related to resource support indicate the resource or operation is not implemented.
- API errors returned from Datto RMM will be surfaced; ensure the API token has sufficient permissions.
Resolutions:
- Verify API credentials and permissions.
- Check network connectivity and API endpoint configuration.
- Use "Retrieve All" option to avoid manual pagination mistakes.
- Confirm field names in "Fields to Include" match those supported by the API.