Pulse Office Action icon

Pulse Office Action

Office actions from Pulse API

Actions17

Overview

The "Create Employee" operation in this node allows users to add a new employee record into the system, either by associating an existing person or by creating a new person profile alongside the employee. This is useful for HR automation workflows where employee data needs to be programmatically managed, such as onboarding new hires, updating organizational structures, or integrating with payroll and planning systems.

Practical examples include:

  • Automatically creating employee records when a new hire form is submitted.
  • Syncing employee data from external HR platforms.
  • Creating employees with detailed personal information and organizational assignments in one step.

Properties

Name Meaning
New Person Boolean flag indicating whether to create a new person profile along with the employee (true) or associate an existing person by ID (false).
Person ID * The identifier of an existing person to link with the new employee (required if not creating a new person).
First Name * First name of the person to create (required if creating a new person).
Middle Name Middle name of the person to create (optional).
Last Name * Last name of the person to create (required if creating a new person).
Gender Gender of the person to create; options are "Male" or "Female" (default: Male).
Birthday Birthday of the person to create (optional).
Relationship Status Relationship status of the person; options are "Single" or "Married" (default: Single).
Number of Kids Number of children the person has (minimum 0, default 0).
Secondary Email Secondary email address of the person (optional).
Phone Number Contact phone number of the person (optional).
Address Address of the person (optional).
Place of Birth Place of birth of the person (optional).
Spouse Name Name of the spouse (optional).
Mother's Name Mother's name (optional).
Father's Name Father's name (optional).
Organizational Unit * The organizational unit within the company to which the employee belongs (required).
Planning ID * Identifier of the planning entity to associate with the employee (required).
Manager IDs Comma-separated list of manager IDs to associate with the employee (optional).
Teams Comma-separated list of team names to associate with the employee (optional).
Position * Position title of the employee (required).
Employment Type * Employment type; options include "Full-time", "Part-time", "Freelance", or "Other" (default: Full-time).
Service Number * Service number assigned to the employee (required).
Hired at * Date the employee was hired (required).
Starting Date Starting date of the employee (optional).
Is Manager Boolean indicating if the employee holds a managerial role (optional).
Is HR Boolean indicating if the employee is part of HR (optional).
Terminated Boolean indicating if the employee is terminated (default: false).
Terminated at * Date the employee was terminated (required if terminated is true).
On Hold Boolean indicating if the employee is currently on hold (optional, relevant if terminated).
Emergency Contact Name Name of the emergency contact person (optional).
Emergency Contact Phone Phone number of the emergency contact (optional).
Emergency Contact Relationship Relationship of the emergency contact to the employee (optional).
End of probation date Date when the employee's probation period ends (optional).
Department Department service of the employee; options include HR, Training, Production, Operation, LAB, Compliance, IT/Dev, IT, Finance, Sales (optional).
Job Classification Group classification of the employee's position; options include Officer, Outsourcer, Agent, Project manager, Manager, Director, Team leader, Automation Architect, Production Assistant, Data Analyst, Cloud (optional).
Category Professional category/job level; options include HC, 5B, 1B (optional).
Group Professional group/job sublevel; options include I, II, III, IV, V (optional).
Create an account Boolean indicating whether to create a user account for the employee (optional).
Account Email * Email address for the created account (required if creating an account).
Account Type * Type of account to create; currently only "Personal Account" is available (default: Personal Account).
Account Expiration Date Expiration date of the created account (optional).

(* indicates required fields depending on context)

Output

The output JSON contains the newly created employee object with all its properties as returned by the underlying API. This includes identifiers, personal details (if a new person was created), organizational assignments, employment details, and optionally account creation results.

No binary data output is produced by this operation.

Dependencies

  • Requires connection to the Pulse API via an API key credential configured in n8n.
  • The node depends on the Pulse API helper utilities to perform authenticated requests.
  • Proper permissions on the API side to create employees and associated persons/accounts are necessary.

Troubleshooting

  • Missing Required Fields: Errors will occur if mandatory fields like Person ID (when not creating a new person), Organizational Unit, Planning ID, Position, Service Number, or Hired At date are missing. Ensure these are provided.
  • Invalid Date Formats: Dates must be in ISO 8601 format. Incorrect formats may cause API errors.
  • Manager IDs and Teams Format: These should be comma-separated strings without extra spaces or invalid characters.
  • Account Creation Errors: If "Create an account" is enabled but the Account Email is missing or invalid, the operation will fail.
  • API Authentication Failures: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Terminated Employee Requirements: If the employee is marked as terminated, the termination date must be provided; otherwise, an error will be thrown.

Links and References

Discussion