Actions25
Overview
The node integrates with the Whoz talent management platform, specifically enabling operations on talents such as creating, updating, deleting, and retrieving talent records. The Update Talent operation allows users to modify existing talent information by specifying the unique Talent ID and providing any fields that need to be updated.
This node is beneficial in scenarios where organizations want to keep their talent database synchronized with external systems or automate updates to talent profiles based on workflow triggers. For example, when a talent's contact details or operational history changes, this node can update those details automatically without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Talent ID | The unique identifier of the talent to update. This is required to specify which talent record will be modified. |
| Additional Fields | A collection of optional fields to update for the talent, including: - External ID (external system identifier) - Initials - Email Address - Create User Account (boolean) - Phone Number - Gender (Male, Female, Other) - Birth Date - Manager ID / Manager External ID - Mentor ID / Mentor External ID - Staffable (boolean) - Freely Assignable (boolean) - Time Zone (e.g., Europe/Paris) - Daily Hours (number) - Years of Experience (number) - Working Life Entry Date |
| Address | A collection of address-related fields to update, including: - Street - City - Postal Code - Country Code (ISO 3166-1 alpha-2) - Latitude - Longitude |
| Operational History | A collection representing the talent's operational history, including: - Grade ID / Grade External ID - Role ID / Role External ID - Unit Cost Value and Currency (EUR, USD, GBP, CHF, CAD) - Unit Rate Value and Currency - Internal Rate Value and Currency - Organizational Unit |
Output
The output JSON contains the updated talent object returned from the Whoz API after the update operation. It includes all the fields of the talent record, reflecting the changes made. The structure corresponds to the talent data model used by Whoz, typically including identifiers, personal details, contact info, address, operational history, and other metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Whoz talent management platform via an OAuth2 API credential.
- The node uses the Whoz API endpoints to perform the update operation (
POST /talent/bulk/save). - Proper API credentials and environment configuration (sandbox or production) must be set up in n8n for authentication and endpoint resolution.
Troubleshooting
- Missing Talent ID: The operation requires a valid Talent ID. If omitted or incorrect, the node will throw an error indicating the missing or invalid identifier.
- API Errors: Errors returned from the Whoz API (e.g., invalid field values, permission issues) are caught and surfaced as node errors. Review the error message for details.
- Invalid Field Values: Providing unsupported or incorrectly formatted values (e.g., invalid date format, wrong currency code) may cause the API to reject the request.
- Network Issues: Connectivity problems or misconfigured credentials can lead to failed requests. Verify network access and credential validity.
- To resolve errors, ensure all required fields are correctly provided, validate input formats, and confirm API credentials and permissions.
Links and References
- Whoz Talent Management Platform (official site)
- Whoz API documentation (not publicly linked here; refer to your organization's API docs or Whoz support)
- n8n OAuth2 Credential Setup Guide: https://docs.n8n.io/credentials/oauth2/