​
Overview

The Create Employee feature enables you to create new employee records in a connected HRIS with a structured, simplified approach. Instead of manually building separate integrations for each HRIS system, this feature dynamically generates forms based on the specific requirements of the connected system.

​
Key Benefits

  • Unified Integration: Use a single API to create employees across any supported HRIS
  • Dynamic Form Generation: Automatically retrieve the required fields for each HRIS
  • Smart Field Mapping: Map your existing data to HRIS fields using unified keys
  • Validation Built-in: Form schema includes validation rules to ensure data accuracy
  • Intuitive UI Support: Guidelines for building user-friendly interfaces

​
How It Works

  1. Fetch Form Schema: Retrieve a dynamic schema from the connected HRIS that defines all required and optional fields
  2. Auto-map Fields: Use unified keys to automatically map standard fields (name, email, etc.) from your data
  3. Collect Missing Data: Generate UI components to collect any additional required information
  4. Submit Data: Send the validated data to create the new employee record

​
Implementation

This feature is implemented through two primary endpoints:

Get Employee Form

Retrieve the form schema for a connected HRIS with required fields and validation rules.

Create Employee

Submit the populated form data to create a new employee record in the HRIS.
The form schema includes detailed information about each field:
  • Field type (text, number, date, select, etc.)
  • Validation rules (required, min/max values)
  • Unified keys for standard fields
  • Description and labels

​
Getting Started

To implement this feature in your application:
  1. Set up a connection to an HRIS via Kombo Connect
  2. Fetch the form schema for the connected HRIS
  3. Build a UI that displays the required fields and collects user input
  4. Submit the populated form data to create the employee

Detailed Implementation Guide

Ready to implement? Our detailed step-by-step guide covers everything from setting up connections to handling field mapping and validation.