PaperCut Health API icon

PaperCut Health API

Interact with the PaperCut MF / NG health monitoring api
Join our community

Actions10

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 Pages Count operation, this node retrieves the number of pages processed within a specified recent time window (in minutes). This is useful for monitoring print activity trends, generating usage reports, or triggering alerts based on recent printing volume.

Practical examples:

  • Monitor how many pages have been printed in the last 10 minutes.
  • Trigger an alert if the number of pages printed exceeds a certain threshold in a short period.
  • Generate periodic reports on recent print activity for auditing or optimization purposes.

Properties

Name Type Meaning
Minutes Number Number of minutes to look back for counting recent pages (max value 240)

Output

The node outputs a json object containing the count of pages processed in the specified recent time window. The exact structure may vary depending on the API response, but typically includes:

{
  "recentPagesCount": <number>
}
  • recentPagesCount: The total number of pages processed in the last N minutes.

Note: If the API returns additional fields, they will also be included in the output.

Dependencies

  • External Service: Requires access to a running instance of the PaperCut MF / NG server 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).

Troubleshooting

Common Issues:

  • Invalid Credentials: If the credentials are incorrect or missing, authentication errors will occur. Ensure the paperCutHealthApi credential is set up correctly in n8n.
  • Minutes Value Exceeds Limit: If you specify 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.
  • Network/SSL Errors: If the PaperCut server uses a self-signed certificate and selfSigned is not enabled, SSL errors may occur.
  • API Unreachable: If the PaperCut server is down or the domain is incorrect, connection errors will be thrown.

Error Messages & Resolutions:

  • "401 Unauthorized" – Check your API credentials.
  • "400 Bad Request" – Verify that the "Minutes" property is within the allowed range.
  • "ENOTFOUND" or "ECONNREFUSED" – Confirm the server address and network connectivity.

Links and References

Discussion