Actions25
Overview
The node enables interaction with the Whoz talent management platform, specifically allowing operations on accounts (companies/organizations). The Update Account operation modifies details of an existing account by specifying its unique ID and providing any fields to update.
This operation is useful when you need to keep your account data in sync with changes from other systems or manual updates. For example, updating the description, industry sector, website URL, or address of a company record in Whoz after receiving new information from a CRM or ERP system.
Properties
| Name | Meaning |
|---|---|
| Account ID | The unique identifier of the account to update (required). |
| Additional Fields | Optional extra fields to update on the account: |
| - External ID: External system identifier for this account. | |
| - Description: Text description of the account. | |
| - Owner ID: Identifier of the account owner. | |
| - Owner External ID: External ID of the account owner. | |
| - Parent Account ID: Identifier of the parent account. | |
| - Parent Account External ID: External ID of the parent account. | |
| - Website: Website URL of the account. | |
| - Industry: Industry sector of the account. | |
| - Employee Count: Number of employees in the organization. | |
| - Annual Revenue Value: Numeric value of annual revenue. | |
| - Annual Revenue Currency: Currency code for annual revenue (EUR, USD, GBP, CHF, CAD). | |
| - Tags: Comma-separated list of tags associated with the account. | |
| Address | Optional address fields to update: |
| - Street: Street address. | |
| - City: City name. | |
| - State/Province: State or province name. | |
| - Postal Code: Postal or ZIP code. | |
| - Country Code: ISO 3166-1 alpha-2 country code (e.g., FR, US). | |
| - Latitude: GPS latitude coordinate (number). | |
| - Longitude: GPS longitude coordinate (number). |
Output
The output JSON contains the updated account object as returned by the Whoz API. This typically includes all the account's current properties after the update, such as IDs, descriptions, owner info, address, industry, employee count, revenue, tags, and any other fields supported by the API.
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 endpoints, requiring network access and valid authentication tokens.
- The base URL depends on the environment setting (sandbox or production).
Troubleshooting
- Missing Required Fields: If the Account ID is not provided, the node will throw an error indicating that required fields are missing.
- Invalid Account ID: Providing an incorrect or non-existent Account ID may result in API errors or no update occurring.
- API Authentication Errors: Ensure the OAuth2 credentials are correctly configured and have not expired.
- Field Validation Errors: Some fields like currency codes or numeric values must be valid; otherwise, the API may reject the request.
- Network Issues: Connectivity problems can cause request failures; verify network access to the Whoz API endpoints.
If an error occurs, the node returns the error message from the API or a generic error if unknown.
Links and References
- Whoz Platform Documentation (general reference)
- OAuth2 API setup documentation within n8n for configuring credentials
- ISO 3166-1 alpha-2 country codes: https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes