Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Timeslot → List Of Timeslot

AI-generated

Overview

This node integrates with the Halo PSA API to perform various operations on different resources. Specifically, for the Timeslot resource and the List Of Timeslot operation, it retrieves a list of timeslots filtered optionally by agent ID and/or workday ID.

Typical use cases include:

  • Fetching available or booked timeslots for a specific agent.
  • Retrieving timeslots associated with a particular workday.
  • Automating scheduling workflows by integrating timeslot data into broader processes.

For example, you might use this node to get all timeslots assigned to an agent before creating a calendar event or to check availability on a given workday.

Properties

Name Meaning
Agent Id Optional filter to retrieve timeslots associated with a specific agent.
Workday Id Optional filter to retrieve timeslots linked to a particular workday.

Both properties are sent as query parameters in the API request to filter the results accordingly.

Output

The node outputs an array of JSON objects representing timeslots. Each item corresponds to one timeslot returned by the API. The exact structure depends on the Halo PSA API response but typically includes details such as timeslot ID, start and end times, associated agent, and workday information.

If the node encounters errors during execution (e.g., network issues or invalid parameters), it outputs an error object with a message describing the problem.

The node does not output binary data for this operation.

Dependencies

  • Requires valid credentials for the Halo PSA API, including base URL, tenant identifier, client ID, and client secret.
  • The node uses these credentials to authenticate API requests via custom headers.
  • No additional external dependencies beyond the Halo PSA API and n8n's HTTP request capabilities.

Troubleshooting

  • No credentials returned!
    This error indicates missing or misconfigured API credentials. Ensure that the required API authentication details are correctly set up in n8n.

  • Resource or Operation not found
    Occurs if the specified resource or operation is invalid or unsupported. Verify that "Timeslot" and "List Of Timeslot" are correctly selected.

  • API request failures
    Network issues, incorrect filters, or API downtime can cause request errors. Check connectivity, parameter values, and Halo PSA service status.

  • JSON parsing errors
    If using advanced parameters like jsonParameters or queryParameters, ensure JSON strings are well-formed.

To resolve most issues, verify credentials, input parameters, and network access.

Links and References

Discussion