Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Contactgroup → Delete Undefined

AI-generated

Overview

This node integrates with the Halo PSA API to perform various operations on different resources. Specifically, for the Contactgroup resource and the Delete Undefined operation, it deletes a contact group identified by its ID. This is useful in scenarios where you want to programmatically remove obsolete or unwanted contact groups from your Halo PSA system.

Practical examples include:

  • Automating cleanup of contact groups that are no longer needed.
  • Integrating with other workflows to delete contact groups based on external triggers or conditions.

Properties

Name Meaning
Id The unique numeric identifier of the contact group to be deleted. This property is required.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output item contains a json field with the response from the Halo PSA API after attempting to delete the specified contact group.

  • On success, the json field will contain the API's confirmation or details about the deletion.
  • On failure, if "Continue On Fail" is enabled, the json field will contain an error property with the error message.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the Halo PSA API, including base URL, tenant identifier, client ID, and client secret.
  • The node expects these credentials to be configured in n8n prior to execution.
  • Network access to the Halo PSA API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Missing or invalid credentials will cause the node to throw an error indicating no credentials were returned.
    • Providing an invalid or non-existent contact group ID will result in an API error.
    • Network connectivity problems can cause request failures.

  • Error messages:

    • "No credentials returned!": Ensure that the Halo PSA API credentials are properly set up in n8n.
    • "Resource Contactgroup not found" or "Operation Delete Undefined not found for resource Contactgroup": Indicates misconfiguration of resource or operation parameters.
    • API errors related to deletion (e.g., "Not Found", "Unauthorized") should be checked against the Halo PSA API documentation and credentials.

  • To handle errors gracefully, enable the "Continue On Fail" option so the workflow can proceed even if some deletions fail.

Links and References

Discussion