Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Section Detail → List Of Section Detail

AI-generated

Overview

This node integrates with the Halo PSA API to retrieve detailed information about sections (teams or groups) within an organization. Specifically, the "List Of Section Detail" operation fetches a filtered list of section details based on various criteria such as permissions, department, status, and membership.

Common scenarios where this node is beneficial include:

  • Retrieving teams that a user can edit or belongs to.
  • Filtering teams by department or status (enabled/disabled).
  • Getting counts of tickets or projects associated with teams.
  • Including additional related data like managers or agents for specific teams.

Practical example:

  • A support manager wants to list all enabled teams in a particular department that are involved in live chat, including their managers and ticket counts, to analyze workload distribution.

Properties

Name Meaning
Can Edit Only Filter on teams that you have permission to edit (boolean).
Chat Only Filter on teams that are enabled for live chat (boolean).
Department Id Filter teams belonging to a particular department (integer).
Domain Filter domain for counts: reqs (tickets), opps (opportunities), prjs (projects) (string).
Ids Filter by team IDs, comma separated (string).
Include Managers Include managers in the response (boolean).
Includeagentsforteams Comma separated list of team names; agents in these teams will be returned (string).
Includedisabled Include disabled teams in the response (string).
Includeenabled Include enabled teams in the response (string).
Istree No description provided; likely a boolean flag to return data in tree structure (boolean).
Memberonly Only returns sections that the current agent is a member of (boolean).
Mydeps No description provided; possibly filters by user's departments (boolean).
Myteamsonly Only returns sections that you are a member of (boolean).
Orderbyseq Order results by sequence number (boolean).
Outcome Id No description provided; likely filters by outcome identifier (integer).
Showall Admin override to show all teams, overriding team permissions (boolean).
Showcounts Show the count of tickets in the response (boolean).
Ticketarea Id For showcounts only - filter by ticket area (integer).
Type Filter by team domain: reqs (tickets), opps (opportunities), prjs (projects) (string).
View Id For showcounts only - filter by ticket view (integer).

Output

The node outputs JSON data containing the list of section details matching the specified filters. Each item in the output corresponds to a section (team) with its properties as returned by the Halo PSA API.

If requested via properties, the output may also include:

  • Managers of the teams.
  • Agents belonging to specified teams.
  • Counts of tickets or other domain-specific metrics.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Halo PSA API.
  • The node uses the base URL, tenant ID, client ID, and client secret from the credentials to make authenticated requests.
  • No additional external dependencies beyond the Halo PSA API.

Troubleshooting

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

  • Resource or Operation not found
    If the specified resource or operation does not exist, verify that the correct resource ("Section Detail") and operation ("List Of Section Detail") are selected.

  • Invalid parameter values
    Passing incorrect types or malformed strings (e.g., invalid JSON in query parameters) may cause request failures. Validate input property values before execution.

  • API request errors
    Network issues, invalid credentials, or insufficient permissions may cause API call failures. Check API connectivity and credential validity.

  • When using boolean filters, ensure the values are correctly set (true/false) to avoid unexpected filtering results.

Links and References

Discussion