Halo PSA icon

Halo PSA

Consume Halo PSA API

Actions795

Sales Mailbox → 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 Sales Mailbox resource and the Post Undefined operation, it sends a POST request with a JSON body to create or update mailbox-related data.

Typical use cases include automating mailbox management tasks such as creating new sales mailboxes or updating existing ones in Halo PSA directly from an n8n workflow. For example, a user might automate the creation of mailboxes based on incoming leads or synchronize mailbox configurations from another system.

Properties

Name Meaning
Body A JSON object representing the mailbox data to be sent to the API. The default structure includes a mailboxes array, which can contain one or more mailbox objects with their respective properties. Users should provide valid mailbox details according to the Halo PSA API schema.

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 by the Halo PSA API after performing the POST operation on the Sales Mailbox resource.
  • pairedItem: Metadata linking the output to the original input item index.

If the operation involves binary data (not applicable here), the node would handle it accordingly, but for this operation, only JSON responses are expected.

Dependencies

  • Requires an active connection to the Halo PSA API via an API key credential that provides:

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

  • The node uses these credentials to authenticate requests by setting appropriate headers.

  • No additional external dependencies beyond the Halo PSA API and standard n8n environment.

Troubleshooting

  • No credentials returned!
    This error occurs if the node cannot retrieve the required API authentication credentials. Ensure that the API key credential is properly configured and connected in n8n.

  • Resource or Operation not found
    If the specified resource or operation does not exist in the node's configuration, verify that the correct resource ("Sales Mailbox") and operation ("Post Undefined") are selected.

  • JSON parsing errors
    Since the "Body" property expects a JSON string, invalid JSON syntax will cause parsing failures. Validate the JSON format before running the node.

  • API request failures
    Errors returned from the Halo PSA API (e.g., authentication failure, invalid data) will be surfaced. Check the error message for details and ensure all required fields and credentials are correct.

  • Continue On Fail behavior
    If enabled, the node will continue processing subsequent items even if some fail, returning error messages in the output JSON.

Links and References

Discussion