HaloPSA Complete icon

HaloPSA Complete

Get data from the HaloPSA API

Overview

This node integrates with the HaloPSA API to manage various resources, including agents. Specifically, the Agent Delete operation allows users to delete an agent by specifying its unique ID. This is useful in scenarios where you need to programmatically remove agents from your HaloPSA system, such as cleaning up inactive or obsolete agents.

Practical examples include:

  • Automating the removal of agents who have left the company.
  • Cleaning up test or temporary agents created during onboarding or testing.
  • Integrating with HR systems to sync agent status and automatically delete agents no longer active.

Properties

Name Meaning
Agent ID The unique numeric ID of the agent to delete

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will be a confirmation response from the HaloPSA API indicating whether the deletion was successful. The exact structure depends on the API's response but generally includes status information.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the HaloPSA API.
  • The node uses the HaloPSA API endpoint related to agents.
  • Proper network access to the HaloPSA service is necessary.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Agent ID will likely cause the API to return an error.
    • Insufficient permissions or invalid API credentials can lead to authentication errors.
    • Network connectivity problems may prevent the node from reaching the HaloPSA API.
  • Error messages and resolutions:

    • "Agent not found" — Verify that the Agent ID exists in the HaloPSA system.
    • "Unauthorized" or "Authentication failed" — Check that the API key credential is correctly configured and has sufficient permissions.
    • Timeout or network errors — Ensure the n8n instance has internet access and the HaloPSA API endpoint is reachable.

Links and References

Discussion