Actions25
Overview
This node integrates with the Whoz talent management platform to create new talent records. It allows users to add detailed information about a talent, including personal details, operational history, and address data. This operation is useful for HR teams or workforce planners who want to automate the onboarding or registration of talents into the Whoz system.
Typical use cases include:
- Automatically adding new employees or contractors to the talent database.
- Importing talent data from other systems into Whoz.
- Setting up detailed profiles with operational and contact information for workforce management.
Properties
| Name | Meaning |
|---|---|
| First Name | The first name of the talent (required). |
| Last Name | The last name of the talent (required). |
| Federation ID | Identifier of the federation managing this talent (required). |
| Scope | Type of talent; options are: Employee, Alumni, External, Pool, Pre-boarding (required). |
| Workspace ID | Identifier of the workspace for the operational situation (required). |
| Since Date | Effective date for the operational situation in YYYY-MM-DD format (required). |
| Additional Fields | Optional extra fields including: External ID, 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, Daily Hours, Years of Experience, Working Life Entry Date. |
| Address | Optional address details including Street, City, Postal Code, Country Code (ISO 3166-1 alpha-2), Latitude, Longitude. |
| Operational History | Optional operational history fields including Grade ID, Grade External ID, Role ID, Role External ID, Unit Cost Value & Currency, Unit Rate Value & Currency, Internal Rate Value & Currency, Organizational Unit. |
Output
The output JSON contains the newly created talent record as returned by the Whoz API. This includes all submitted fields along with any additional metadata or identifiers assigned by the platform.
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 REST API endpoint
/talent/bulk/saveto create talent records. - The base URL depends on the environment setting in credentials (sandbox or production).
- Proper API authentication and permissions are necessary to perform create operations.
Troubleshooting
- Missing Required Fields: If required fields like First Name, Last Name, Federation ID, Scope, Workspace ID, or Since Date are missing, the node will throw validation errors. Ensure all mandatory inputs are provided.
- API Errors: Errors returned from the Whoz API (e.g., invalid federation ID, unauthorized access) will be caught and surfaced. Check API credentials and input correctness.
- Date Format Issues: The "Since Date" must be in
YYYY-MM-DDformat. Incorrect formats may cause request failures. - Network Issues: Connectivity problems to the Whoz API endpoint can cause timeouts or errors. Verify network access and endpoint availability.
- Boolean Field Defaults: Some boolean fields default to false or true; ensure these are set correctly according to your needs to avoid unintended behavior.
Links and References
- Whoz Talent Management Platform (official site)
- Whoz API documentation (not publicly linked here; consult your Whoz account or support for API docs)
- n8n Documentation on OAuth2 Credentials and HTTP Request Nodes for custom integrations