Whoz icon

Whoz

Interact with Whoz talent management platform
Join our community

Actions25

Overview

This node integrates with the Whoz talent management platform, specifically allowing operations on billing items among other resources. The "Delete" operation for the "Billing Item" resource enables users to remove a specific billing item from their Whoz account by providing its unique ID.

Common scenarios where this node is beneficial include:

  • Automating cleanup of obsolete or incorrect billing items.
  • Integrating billing item management into broader workflows that handle financial or project data.
  • Synchronizing billing data between Whoz and other systems by programmatically deleting entries.

For example, a user might set up an automation that deletes billing items once a related project is completed or canceled, ensuring accurate billing records.

Properties

Name Meaning
Billing Item ID The unique identifier of the billing item to delete. This is required to specify which billing item should be removed.

Output

The output JSON will contain the response from the Whoz API after attempting to delete the billing item. Typically, it includes:

  • A success boolean indicating whether the deletion was successful.
  • The id of the deleted billing item.
  • Additional fields returned by the API that may provide further context or confirmation.

Example output structure:

{
  "success": true,
  "id": "billingItemId123",
  "...additionalApiResponseFields": "..."
}

No binary data output is involved in 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:

    • Providing an invalid or non-existent Billing Item ID will likely result in an error from the API.
    • Network connectivity problems or incorrect API credentials can cause request failures.
    • Attempting to delete a billing item without sufficient permissions may lead to authorization errors.

  • Error messages and resolutions:

    • "Unknown billing item operation": Indicates the operation parameter is incorrect; ensure "delete" is selected.
    • API errors related to missing or invalid Billing Item ID: Verify the ID is correct and exists in the Whoz system.
    • Authentication errors: Check that the OAuth2 credentials are valid and have not expired.
    • If the node throws a generic error, enabling "Continue On Fail" can help identify problematic inputs without stopping the entire workflow.

Links and References

Discussion