Actions25
Overview
The node integrates with the Whoz talent management platform to perform operations on accounts, which represent companies or organizations. Specifically, the "Account - Create" operation allows users to create a new account in the Whoz system by providing essential details such as the account's name, type, and workspace association, along with optional additional information like address, description, and tags.
This node is beneficial in scenarios where you want to automate the creation of organizational records within Whoz from other systems or workflows, such as CRM platforms, marketing tools, or onboarding processes. For example, when a new customer signs up in your CRM, this node can automatically create a corresponding account in Whoz to keep talent and organizational data synchronized.
Properties
| Name | Meaning |
|---|---|
| Name | The name of the account (company/organization) to be created. |
| Type | The category of the account. Options include: Customer, Partner, Competitor, Federation, Internal. |
| Workspace ID | Identifier of the workspace within Whoz where the account will be created. |
| Additional Fields | Optional extra fields to provide more context about the account: - External ID: Identifier used in an external system for this account. - Description: Textual description of the account. - Owner ID / Owner External ID: Identifiers for the account owner. - Parent Account ID / Parent Account External ID: Identifiers for the parent account if applicable. - Website: URL of the account's website. - Industry: Industry sector of the account. - Employee Count: Number of employees. - Annual Revenue Value & Currency: Financial revenue details. - Tags: Comma-separated tags for categorization. |
| Address | Collection of address-related fields: - Street, City, State/Province, Postal Code, Country Code (ISO 3166-1 alpha-2 format). - Latitude and Longitude coordinates for geolocation. |
Output
The output JSON contains the newly created account's data as returned by the Whoz API. This typically includes all the properties sent during creation plus any additional metadata assigned by the platform, such as unique identifiers or timestamps.
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, with the base URL dynamically selected based on the environment (sandbox or production).
- Proper configuration of the API authentication token or credentials in n8n is necessary for successful requests.
Troubleshooting
- Missing Required Fields: If required fields like "Name", "Type", or "Workspace ID" are not provided, the node will throw validation errors. Ensure these are set before execution.
- Authentication Errors: Invalid or expired API credentials will cause authentication failures. Verify that the OAuth2 credentials are correctly configured and refreshed.
- API Request Failures: Network issues or incorrect endpoint usage may result in errors. Check connectivity and ensure the Whoz API service is operational.
- Invalid Field Values: Providing unsupported values for enumerated fields (e.g., "Type") or malformed address data may cause the API to reject the request. Use only allowed options and valid formats.
- Error Messages: The node surfaces error messages returned by the Whoz API. Review these messages for clues and consult Whoz documentation or support if needed.
Links and References
- Whoz Official Website
- Whoz API Documentation (Assumed URL; replace with actual if available)
- n8n OAuth2 Credential Setup