Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Service Category → List Of Service Category

AI-generated

Overview

This node integrates with the Halo PSA API to perform various operations on different resources. Specifically, for the Service Category resource and the List Of Service Category operation, it retrieves a list of service categories from the Halo PSA system. This is useful in scenarios where you want to fetch and display or process service category data within an automation workflow, such as generating reports, syncing categories with other systems, or filtering tickets by category.

Practical examples:

  • Automatically retrieving all service categories to populate dropdowns in a custom form.
  • Syncing service categories with an external database or CRM.
  • Filtering IT service tickets based on their associated service category.

Properties

Name Meaning
Access Control Level Filter service categories by access control level.
Include Parent Name Option to include the parent category name in the response.
Itil Ticket Type Filter service categories by ITIL ticket type.
User Id Filter service categories related to a specific user ID.

These properties are sent as query parameters to the API when listing service categories.

Output

The node outputs JSON data representing the list of service categories retrieved from the Halo PSA API. Each item in the output corresponds to one service category object as returned by the API.

The exact structure depends on the API response but typically includes fields like category ID, name, description, parent category (if included), and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Halo PSA API via credentials that provide:

    • Base URL of the Halo PSA instance.
    • Tenant identifier.
    • Client ID and Client Secret for authentication.
  • The node uses these credentials to authenticate API requests.

Troubleshooting

  • No credentials returned!
    This error occurs if the node cannot find or access the required API credentials. Ensure that valid credentials are configured in n8n before running the node.

  • Resource or Operation not found
    If the specified resource or operation does not exist, verify that the correct resource ("Service Category") and operation ("List Of Service Category") names are used.

  • API request errors
    Errors from the API (e.g., authentication failure, invalid query parameters) will be returned in the node output if "Continue On Fail" is enabled; otherwise, they will stop execution. Check the error message for details and verify API credentials and parameter values.

Links and References

Discussion