PaperCut Health APIInstall

Overview

The PaperCut Health API node for n8n allows you to interact with the PaperCut MF / NG health monitoring API. Specifically, when using the Statistics resource and the Recent Warnings Count operation, this node retrieves the number of warning events that have occurred within a specified time window (in minutes) from your PaperCut system. This is useful for administrators who want to monitor recent warning activity, set up alerts, or generate reports on system health.

Practical examples:

• Automatically alert IT staff if the number of warnings spikes in the last 30 minutes.
• Generate periodic reports on warning trends for compliance or auditing purposes.
• Integrate with dashboards to visualize recent warning counts.

Properties

Output

The node outputs a json object containing the count of recent warnings within the specified time window. The exact structure may vary depending on the API response, but typically it will include a field representing the count of warnings.

Example output:

{
  "recentWarningsCount": 5
}

Note: The actual key name may differ based on the API's response format.

Dependencies

• External Service: Requires access to a running PaperCut MF / NG instance with the health monitoring API enabled.
• API Credentials: You must configure the paperCutHealthApi credentials in n8n, including:
  • domain: The base URL of your PaperCut server.
  • selfSigned: Whether to skip SSL certificate validation (for self-signed certificates).
• n8n Configuration: Ensure network connectivity between n8n and the PaperCut server.

Troubleshooting

Common issues:

• Invalid Credentials: If the API credentials are incorrect or missing, authentication errors will occur. Double-check the paperCutHealthApi credential settings.
• Network Errors: If n8n cannot reach the PaperCut server (e.g., due to firewall rules or incorrect domain), requests will fail.
• Minutes Value Exceeded: If you provide a value greater than 240 for "Minutes", the API may return an error or ignore the request. Always use a value between 1 and 240.
• SSL Certificate Issues: If your PaperCut server uses a self-signed certificate and you haven't enabled "Skip SSL Certificate Validation," connection errors may occur.

Error messages and resolutions:

• "401 Unauthorized": Check your API credentials.
• "Connection refused" or "ENOTFOUND": Verify the domain and network connectivity.
• "Invalid parameter: minutes": Ensure the "Minutes" property is within the allowed range.

Links and References

• PaperCut MF/NG Health Monitoring API Documentation
• n8n Documentation: Creating and Using Credentials
• n8n Community Forum