> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Employee

> Streamline employee onboarding with a dynamic form-based solution for creating employee records in connected HRIS systems.

## 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:

<CardGroup cols={2}>
  <Card title="Get Employee Form" icon="align-left" href="/hris/v1/get-employees-form">
    Retrieve the form schema for a connected HRIS with required fields and
    validation rules.
  </Card>

  <Card title="Create Employee" icon="user-plus" href="/hris/v1/post-employees-form">
    Submit the populated form data to create a new employee record in the HRIS.
  </Card>
</CardGroup>

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](/hris/guides/connect/introduction)
2. [Fetch the form schema](/hris/v1/get-employees-form) for the connected HRIS
3. Build a UI that displays the required fields and collects user input
4. [Submit the populated form data](/hris/v1/post-employees-form) to create the employee

<Card title="Detailed Implementation Guide" icon="book-open" href="/hris/implementation-guide/create-employee" arrow={true}>
  Ready to implement? Our detailed step-by-step guide covers everything from
  setting up connections to handling field mapping and validation.
</Card>

<Card title="Hiring into Positions & Requisitions" icon="briefcase" href="/hris/implementation-guide/staffing-entities-in-create-employee" arrow={true}>
  For enterprise HRIS systems (Workday, UKG Pro, SAP SuccessFactors), hires
  typically need to target a specific position or requisition. Learn how to use
  staffing entities to scope the form and place employees into the correct org
  slot.
</Card>
