LEDGERS icon

LEDGERS

Interact with LEDGERS API
Join our community

Actions34

Overview

This node operation "Add Employee" under the HRMS (India) resource allows users to add a new employee record into an HR management system. It is designed for organizations managing employee data such as personal details, employment status, bank information, and contact details.

Common scenarios where this node is beneficial include:

  • Automating employee onboarding workflows by programmatically adding new employees.
  • Integrating with other systems like payroll, attendance, or benefits platforms by syncing employee data.
  • Maintaining up-to-date employee records in a centralized HRMS.

Practical example: When a new hire joins, an automated workflow can collect their details via a form and use this node to add them to the HRMS database, including their branch assignment, official email, and bank account details for salary processing.

Properties

Name Meaning
Salutation The salutation/title of the employee. Options: Dr., M/s., Mr., Mrs., Ms., Prof.
Name Full name of the employee.
Branch Name or ID The branch where the employee works. Select from a dynamically loaded list of branches or specify an ID using an expression.
Date of Join The date when the employee joined the company.
Personal Mobile Employee's personal mobile phone number.
Office Email Official email address assigned to the employee.
Employee Status Employment status. Options: Active, Resigned, Absconded, Terminated, Furloughed.
Date of Birth Employee's date of birth.
Gender Gender of the employee. Options: Male, Female, Other.
Employee ID Unique identifier for the employee within the organization.
Additional Fields A collection of optional fields including:
- Aadhar Employee's Aadhar number (Indian unique ID).
- Blood Group Blood group of the employee. Options: A-, A+, AB-, AB+, B-, B+, O-, O+.
- Department Department name the employee belongs to.
- Designation Job title or designation of the employee.
- Emergency Contact Emergency contact phone number.
- Employee Account Name (Bank) Bank account holder's name.
- Employee Account Number (Bank) Bank account number.
- Employee Account Type (Bank) Type of bank account. Options: Savings Account, Current Account, Salary Account.
- Employee Bank Branch (Bank) Bank branch name.
- Employee Bank Name (Bank) Name of the bank.
- Employee IFSC Code (Bank) Bank IFSC code (Indian banking system).
- Employee State Insurance Number Employee State Insurance (ESI) number.
- Employment Type Type of employment. Options: Apprentice, Contractual, Full Time, Part Time.
- Father Name Father's name of the employee.
- Marital Status Marital status. Options: Single, Married, Divorced, Widowed.
- Office Mobile Official mobile phone number.
- PAN PAN card number (Indian tax identification).
- Permanent Address Permanent address details as multiple entries with fields: Address Line 1, Address Line 2, City, Country, Pincode, State.
- Personal Email Personal email address of the employee.
- Present Address Present address details similar to permanent address structure.
- Religion Religion of the employee.
- Reporting Name or ID The manager or reporting person for the employee. Select from a dynamically loaded list or specify an ID using an expression.
- Shift Timing Work shift timing in format HH:MM:SS-HH:MM:SS.
- UAN Number Universal Account Number for Provident Fund (PF) in India.

Output

The node outputs JSON data representing the newly added employee record as returned by the HRMS API. This typically includes all submitted fields along with any system-generated identifiers or metadata confirming successful creation.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the HRMS backend service.
  • Needs valid credentials including email, password, and API URL configured in n8n.
  • Uses dynamic loading methods to fetch options for branches and reporting employees from the HRMS API.
  • Relies on HTTP requests to the HRMS API endpoints for login and employee creation.

Troubleshooting

  • Authentication failures: Errors indicating failed login usually mean incorrect or expired API credentials. Verify the API key, email, and password are correct and have necessary permissions.
  • Invalid or missing required fields: Ensure all mandatory properties like Salutation, Name, Branch, Date of Join, etc., are provided and correctly formatted.
  • API errors: If the HRMS API returns errors, check the error message for details. Common issues include invalid branch IDs, duplicate employee IDs, or malformed dates.
  • Dynamic option loading fails: If branch or reporting employee lists do not load, verify network connectivity and that the API credentials allow fetching these resources.
  • Date/time formatting: Dates must be in ISO 8601 format; incorrect formats may cause request rejection.

Links and References

Discussion