Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Custom Button → Post Undefined

AI-generated

Overview

This node integrates with the Halo PSA API, allowing users to perform various operations on different resources within the Halo PSA system. Specifically for the "Custom Button" resource and the "Post Undefined" operation, it sends a POST request with a JSON body to a designated endpoint of the Halo PSA API.

Typical use cases include automating interactions with custom buttons configured in Halo PSA, such as triggering specific workflows or actions defined by those buttons. For example, a user might send data to a custom button to initiate a ticket escalation or update a service record programmatically.

Properties

Name Meaning
Body A JSON object representing the request payload sent to the custom button endpoint. This allows flexible data structures to be posted according to the API's requirements.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output item contains:

  • json: The parsed JSON response returned from the Halo PSA API after posting the data to the custom button endpoint.
  • If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message instead of the expected response.

No binary data output is produced by this node.

Dependencies

  • Requires valid credentials for the Halo PSA API, including:

    • Base URL of the Halo PSA instance
    • Tenant identifier
    • Client ID
    • Client Secret

  • These credentials must be configured in n8n prior to using the node.

  • The node uses HTTP requests with appropriate headers for authentication and content type.

Troubleshooting

  • Common Issues:

    • Missing or invalid credentials will cause the node to throw an error indicating no credentials were returned.
    • Incorrect resource or operation names will result in errors stating the resource or operation was not found.
    • Malformed JSON in the "Body" property can cause parsing errors or API request failures.
    • Network issues or incorrect base URL may lead to request timeouts or connection errors.

  • Error Messages:

    • "No credentials returned!": Ensure that the API credentials are properly set up and accessible.
    • "Resource Custom Button not found" or "Operation Post Undefined not found for resource Custom Button": Verify that the resource and operation names match exactly.
    • JSON parsing errors when providing the "Body" parameter: Validate the JSON syntax before input.
    • API errors returned from Halo PSA will be included in the output if "Continue On Fail" is enabled; otherwise, they will stop execution.

Links and References

Discussion