Actions101
- Attendance Actions
- Client Actions
- Department Actions
- Designation Actions
- Employee Actions
- Holiday Actions
- KPI Actions
- KPI Category Actions
- KPI Data Actions
- Lead Actions
- Leave Actions
- OKR Key Result Actions
- OKR Objective Actions
- Performance Cycle Actions
- Project Actions
- Project Category Actions
- Task Actions
- Task Category Actions
- Ticket Actions
- Ticket Agent Actions
- Ticket Channel Actions
- Ticket Type Actions
Overview
The node provides integration with the Flowyteam API to manage employee records, specifically supporting the creation of new employees. It allows users to add detailed employee information such as personal details, contact info, employment status, and organizational assignments.
This node is beneficial in HR automation workflows where new employee data needs to be programmatically added to the company's system. For example, when onboarding a new hire, this node can automatically create their profile in the HR system based on data collected from forms or other sources.
Practical examples:
- Automatically creating an employee record after a successful recruitment process.
- Syncing employee data from external systems into Flowyteam.
- Bulk importing employee data by looping over multiple entries.
Properties
| Name | Meaning |
|---|---|
| Name | Full name of the employee (required) |
| Email address of the employee (required) | |
| Password | Password for the employee account (required, used only on create operation) |
| Joining Date | Date when the employee joined the company (required, format YYYY-MM-DD) |
| Mobile | Employee mobile phone number |
| Gender | Employee gender; options: Male, Female |
| Status | Employee status; options: Active, Inactive |
| Login | Whether the employee can login to the system; options: Enable, Disable |
| Locale | Employee locale/language preference (default "en") |
| Custom Employee ID | Custom employee identifier for the API |
| Address | Employee address |
| Department ID | Numeric ID of the department the employee belongs to |
| Designation ID | Numeric ID of the employee's designation |
| Preferred Name | Employee preferred name |
| Username | Employee username for login |
| Timezone | Employee timezone (default "UTC") |
Output
The node outputs JSON data representing the created employee record as returned by the Flowyteam API. This typically includes all the employee details submitted plus any additional metadata or identifiers assigned by the system.
No binary data output is involved.
Dependencies
- Requires an API key credential for authenticating with the Flowyteam API.
- The node depends on the Flowyteam service being accessible and properly configured.
- No additional environment variables are explicitly required beyond the API authentication setup.
Troubleshooting
Common issues:
- Missing required fields such as Name, Email, Password, or Joining Date will cause errors.
- Invalid date formats for Joining Date may result in API rejection.
- Incorrect or missing API credentials will prevent successful connection.
- Network connectivity issues to the Flowyteam API endpoint.
Error messages:
- Errors indicating unsupported operations or resources suggest misconfiguration of resource/operation parameters.
- Authentication failures usually indicate invalid or expired API keys.
- Validation errors from the API often relate to missing or malformed input properties.
Resolutions:
- Ensure all required fields are provided and correctly formatted.
- Verify API credentials and permissions.
- Check network access and API endpoint availability.
- Confirm that the selected resource is "Employee" and operation is "Create".
Links and References
- Flowyteam official API documentation (refer to your internal or public API docs for detailed endpoints and payloads)
- n8n documentation on creating custom nodes and using credentials
- General best practices for handling employee data securely