Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Costcentres → Get One Costcentres

AI-generated

Overview

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

Common scenarios where this node is beneficial include:

  • Automating financial or project management workflows by retrieving cost centre data.
  • Integrating cost centre information into reporting tools or dashboards.
  • Synchronizing cost centre details between Halo PSA and other systems.

For example, you might use this node to get the budget and allocation details of a particular cost centre before creating a related invoice or project task.

Properties

Name Meaning
Id The unique numeric identifier of the cost centre to retrieve. This is a required field.
Includedetails Optional flag to specify whether to include additional detailed information in the response.

Output

The node outputs JSON data representing the retrieved cost centre. The structure corresponds directly to the Halo PSA API's response for a single cost centre, which typically includes fields such as the cost centre's ID, name, description, and any included detailed information if requested.

If the Includedetails property is set, the output JSON will contain extended details related to the cost centre.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Halo PSA API.
  • Needs credentials providing the base URL, tenant identifier, client ID, and client secret for authentication.
  • The node uses HTTP requests with appropriate headers to authenticate and query the API.

Troubleshooting

  • Missing or invalid credentials: The node will throw an error if the API credentials are not provided or incorrect. Ensure that the API key credential is correctly configured in n8n.
  • Invalid Cost Centre Id: If the specified Id does not exist, the API may return an error or empty response. Verify the Id value.
  • Network issues: Connectivity problems can cause request failures. Check network access to the Halo PSA API endpoint.
  • Malformed input: Providing non-numeric or missing Id will cause errors. Make sure the Id is a valid number.
  • API rate limits or permissions: If the API user lacks permission to read cost centres or exceeds rate limits, errors will occur. Confirm API user rights and usage limits.

When errors occur, the node either throws an exception or returns an error object in the output JSON if "Continue On Fail" is enabled.

Links and References

Discussion