Huntress icon

Huntress

Work with the Huntress API

Actions9

Overview

This node interacts with the Huntress API to retrieve multiple billing reports based on specified filters. It is useful for users who want to programmatically access and analyze billing data such as payment statuses or refunds from their Huntress account. For example, a user could fetch all open billing reports to monitor outstanding invoices or retrieve failed payments to investigate issues.

Properties

Name Meaning
Filters A collection of filter options to narrow down the billing reports returned by the query. The only available filter is: Status, which can be one of the following values: Failed, Full Refund, Open, Paid, or Partial Refund. This filter controls which billing reports are fetched based on their payment status.

Output

The node outputs JSON data representing an array of billing report objects matching the applied filters. Each object contains details about individual billing reports such as their status and other relevant billing information. There is no indication that the node outputs binary data.

Dependencies

  • Requires an API key credential for authenticating with the Huntress API.
  • The node makes HTTP requests to the base URL https://api.huntress.io/v1.
  • Proper configuration of the API key credential in n8n is necessary for successful operation.

Troubleshooting

  • Common Issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Using unsupported filter values may result in empty responses or errors.
    • Network connectivity problems can prevent the node from reaching the Huntress API.
  • Error Messages:

    • Authentication errors typically indicate invalid credentials; verify and update the API key.
    • HTTP status codes returned from the API (e.g., 400, 401, 500) should be checked for more details.
    • If the node returns no data, confirm that the filter criteria match existing billing reports.

Links and References

Discussion