Whoz icon

Whoz

Interact with Whoz talent management platform
Join our community

Actions25

Overview

This node integrates with the Whoz talent management platform, allowing users to perform various operations on different resources such as accounts, talents, dossiers, billing items, and tasks. Specifically, for the Account resource with the Delete operation, the node deletes an account (which represents a company or organization) identified by its unique Account ID.

Common scenarios where this node is beneficial include automating the management of organizational data within Whoz, such as removing obsolete or incorrect accounts from the system. For example, if a company no longer works with your organization, you can automate the deletion of that company's account record in Whoz using this node.

Properties

Name Meaning
Account ID The unique identifier of the account (company/organization) to delete. This is required.

Output

The output JSON contains the result of the delete operation. It typically includes:

  • A success field indicating whether the deletion was successful (true).
  • The id of the deleted account.
  • Any additional response data returned by the Whoz API related to the deletion.

Example output structure:

{
  "success": true,
  "id": "account-id-value",
  "...": "additional response fields"
}

The node does not output binary data for this operation.

Dependencies

  • Requires an active connection to the Whoz talent management platform via an OAuth2 API credential.
  • The node uses the Whoz API endpoint, which varies depending on the environment (sandbox or production).
  • Proper API authentication credentials must be configured in n8n for the node to function.

Troubleshooting

  • Common issues:

    • Invalid or missing Account ID: The node requires a valid Account ID to delete an account. Ensure the ID is correct and exists in Whoz.
    • Authentication errors: If the OAuth2 credentials are invalid or expired, the node will fail to connect to the Whoz API.
    • Network or API downtime: Temporary connectivity issues or Whoz service outages may cause failures.

  • Error messages:

    • "Unknown account operation: delete": Indicates the operation parameter is incorrect or unsupported; ensure "delete" is selected.
    • API error responses from Whoz (e.g., 404 Not Found if the account does not exist): Verify the Account ID and permissions.

  • Resolution tips:

    • Double-check the Account ID input.
    • Refresh or reconfigure the API credentials.
    • Check Whoz service status if persistent network errors occur.

Links and References

Discussion