Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Holidays → Get One Holidays

AI-generated

Overview

This node integrates with the Halo PSA API to retrieve detailed information about a specific holiday by its unique identifier. It is designed to fetch one holiday record at a time, optionally including additional details if requested.

Common scenarios where this node is beneficial include:

  • Automating workflows that need to check or display holiday information for scheduling or planning purposes.
  • Integrating holiday data into other systems such as calendars, HR platforms, or ticketing systems.
  • Fetching holiday details dynamically based on user input or other triggers within an automation.

For example, you might use this node to get the details of a public holiday by its ID and then use that information to adjust task deadlines or notify team members.

Properties

Name Meaning
Id The unique identifier of the holiday to retrieve. This is required to specify which holiday to fetch.
Includedetails Optional flag to include additional details about the holiday in the response.

Output

The node outputs a JSON object representing the holiday data retrieved from the Halo PSA API. The structure of this JSON depends on the API response but typically includes fields such as the holiday's name, date, description, and any additional details if requested.

If the Includedetails property is set, the output will contain more comprehensive information about the holiday.

No binary data output is produced by this operation.

Example output snippet (simplified):

{
  "id": "123",
  "name": "New Year's Day",
  "date": "2024-01-01",
  "description": "First day of the year",
  "details": {
    // Additional details if included
  }
}

Dependencies

  • Requires an API key credential for authenticating with the Halo PSA API.
  • The node expects configuration of the base URL, tenant identifier, client ID, and client secret for the Halo PSA service.
  • Network access to the Halo PSA API endpoint is necessary.

Troubleshooting

  • Missing Credentials Error: If no credentials are provided or they are invalid, the node will throw an error indicating missing credentials. Ensure that the API authentication token and related settings are correctly configured in n8n.
  • Resource or Operation Not Found: Errors may occur if the specified resource ("Holidays") or operation ("Get One Holidays") is not recognized. Verify that the node parameters are correctly set.
  • Invalid Holiday ID: Providing an incorrect or non-existent holiday ID may result in API errors or empty responses. Confirm the ID value before execution.
  • Network or API Errors: Connectivity issues or API downtime can cause request failures. Check network connectivity and Halo PSA service status.
  • JSON Parsing Issues: If additional query parameters or request bodies are malformed JSON, the node may fail. Validate JSON inputs carefully.

Using the node’s "Continue On Fail" option can help handle errors gracefully in workflows.

Links and References

Discussion