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 talents, such as creating, updating, deleting, and retrieving talent records. Specifically, the "Delete" operation for the "Talent" resource enables users to remove a talent entry from the Whoz system by specifying its unique ID.

Common scenarios where this node is beneficial include:

  • Automating the cleanup of talent records that are no longer relevant or needed.
  • Integrating talent lifecycle management into broader workflows, such as offboarding processes.
  • Synchronizing talent data between Whoz and other systems by removing outdated entries.

Example use case:

  • A recruiter wants to automatically delete talent profiles from Whoz when they are marked as inactive in an HR system, ensuring data consistency across platforms.

Properties

Name Meaning
Talent ID The unique ID of the talent to be deleted

Output

The output JSON contains information about the deletion result. It includes:

  • success: A boolean indicating whether the deletion was successful (true).
  • id: The ID of the talent that was deleted.
  • Additional response data returned by the Whoz API related to the deletion operation.

No binary data output is produced by this operation.

Example output JSON:

{
  "success": true,
  "id": "12345",
  "...": "additional API response fields"
}

Dependencies

  • Requires an API key credential for authenticating with the Whoz platform.
  • The node uses the Whoz REST API endpoint, which varies depending on the environment (sandbox or production).
  • Proper configuration of the API authentication credentials in n8n is necessary.
  • The node expects the Whoz API to support DELETE requests at the /talent/{talentId} endpoint.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Talent ID will likely cause the API to return an error.
    • Network connectivity problems or incorrect API credentials can lead to authentication failures.
    • Attempting to delete a talent without sufficient permissions may result in authorization errors.

  • Error messages and resolutions:

    • "Unknown error": General fallback error; check network and API credentials.
    • API-specific error messages from Whoz (e.g., "Talent not found"): Verify the Talent ID is correct and exists.
    • Authentication errors: Ensure the API key or OAuth2 token is valid and has required scopes.

  • To handle errors gracefully, the node supports continuing on failure if configured, allowing workflows to proceed even if some deletions fail.

Links and References

Discussion