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

# UKG Ready HRIS Integration

> UKG Ready connector for Kombo's HRIS API

<Note>This connector is in open beta. You can freely enable it in your account.</Note>

The UKG Ready HRIS integration allows you to sync HRIS data between UKG Ready and your application through Kombo's unified API. The tool slug for this connector is `ukgready`.

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/34023007262353-UKG-Ready-How-do-I-link-my-account">
    Step-by-step instructions to connect your UKG Ready account to Kombo.
  </Card>
</CardGroup>

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Legal Entities">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | address             |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Employees">
      | Field                 | Notes                                                      |
      | --------------------- | ---------------------------------------------------------- |
      | id                    |                                                            |
      | remote\_id            |                                                            |
      | changed\_at           |                                                            |
      | remote\_deleted\_at   |                                                            |
      | employee\_number      |                                                            |
      | first\_name           |                                                            |
      | last\_name            |                                                            |
      | display\_full\_name   |                                                            |
      | work\_email           |                                                            |
      | personal\_email       | The personal email is not exposed via the API.             |
      | mobile\_phone\_number |                                                            |
      | gender                |                                                            |
      | ethnicity             |                                                            |
      | employment\_status    |                                                            |
      | weekly\_hours         | Calculated by multiplying "standard\_work\_day" by 5 days. |
      | avatar                |                                                            |
      | legal\_entity\_id     |                                                            |
      | manager\_id           |                                                            |
      | home\_address         |                                                            |
      | date\_of\_birth       |                                                            |
      | start\_date           |                                                            |
      | termination\_date     |                                                            |
      | custom\_fields        |                                                            |
      | integration\_fields   |                                                            |
      | remote\_data          |                                                            |
    </Accordion>

    <Accordion title="Absence Types">
      | Field                   | Notes |
      | ----------------------- | ----- |
      | id                      |       |
      | remote\_id              |       |
      | changed\_at             |       |
      | remote\_deleted\_at     |       |
      | name                    |       |
      | unit                    |       |
      | half\_days\_supported   |       |
      | exact\_times\_supported |       |
    </Accordion>

    <Accordion title="Absences">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | start\_date         |       |
      | end\_date           |       |
      | start\_time         |       |
      | end\_time           |       |
      | amount              |       |
      | unit                |       |
      | status              |       |
      | type\_id            |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Employments">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | pay\_rate           |       |
      | pay\_period         |       |
      | pay\_currency       |       |
      | effective\_date     |       |
      | remote\_data        |       |
      | custom\_fields      |       |
      | integration\_fields |       |
    </Accordion>

    <Accordion title="Groups">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | type                |       |
      | parent\_id          |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Timesheets">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | started\_at         |       |
      | ended\_at           |       |
      | timezone            |       |
      | payable\_hours      |       |
      | approval\_status    |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Employee <> Group">
      | Field               | Notes |
      | ------------------- | ----- |
      | employee\_id        |       |
      | team\_id            |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Create employee (v2)">
      <Info>For detailed information about [creating employees with form](/hris/implementation-guide/create-employee), please see the [**Create Employee with Form** tab](#create-employee-with-form) above.</Info>

      | Input Field          | Notes |
      | -------------------- | ----- |
      | staffing\_entity\_id |       |
      | properties           |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature               | Notes |
    | --------------------- | ----- |
    | Connection Guide      |       |
    | API Passthrough       |       |
    | Scope Testing         |       |
    | Per Model Tests       |       |
    | Delta Syncs           |       |
    | Group Types           |       |
    | COST\_CENTER          |       |
    | Custom Field Explorer |       |
    | Employees             |       |
  </Tab>

  <Tab title="Create Employee with Form">
    This integration supports multiple employee creation forms for different use cases:

    <Tabs>
      <Tab title="import-tool">
        <ResponseField name="username" type="text">**Username**<br />
        Username for the employee. If not provided, a random value is generated.</ResponseField>
        <ResponseField name="external_id" type="text">**External Id**</ResponseField>
        <ResponseField name="new_employee_id" type="text">**New Employee Id**</ResponseField>
        <ResponseField name="badge_id" type="text">**Badge Id**</ResponseField>
        <ResponseField name="badge_id_2" type="text">**Badge Id 2**</ResponseField>
        <ResponseField name="badge_id_3" type="text">**Badge Id 3**</ResponseField>
        <ResponseField name="ein_tax_id" type="text">**EIN Tax Id**</ResponseField>
        <ResponseField name="ein_name" type="text">**EIN Name**</ResponseField>
        <ResponseField name="primary_ein" type="single_select">**Primary EIN**<br />
        Set to "Y" to mark this EIN as primary for the employee</ResponseField>
        <ResponseField name="employee_sync" type="text">**Employee Sync**</ResponseField>
        <ResponseField name="salutation" type="text">**Salutation**</ResponseField>
        <ResponseField name="first_name" type="text" required>**First Name**<br />
        Maximum 75 characters<br />
        Unified field: `first_name`</ResponseField>
        <ResponseField name="middle_initial" type="text">**Middle Initial**</ResponseField>
        <ResponseField name="last_name" type="text" required>**Last Name**<br />
        The last name of the employee<br />
        Unified field: `last_name`</ResponseField>
        <ResponseField name="nick_name" type="text">**Nick Name**</ResponseField>
        <ResponseField name="social_security" type="text">**Social Security**<br />
        Valid format: 111-11-1111</ResponseField>
        <ResponseField name="allow_change_to_social_security" type="single_select">**Allow Change To Social Security**<br />
        Setting value to "Y" allows changing Social Security Number</ResponseField>
        <ResponseField name="social_insurance_number" type="text">**Social Insurance Number**<br />
        Available only for Canada companies. Valid formats: 111-111-111 or 111111111</ResponseField>
        <ResponseField name="primary_national_id_type" type="text">**Primary National ID Type**</ResponseField>
        <ResponseField name="tax_file_number" type="text">**Tax File Number**<br />
        Available only for Australian companies. 8 digits</ResponseField>
        <ResponseField name="social_security_number_france" type="text">**Social Security Number (France)**<br />
        National ID number for France. Available only for French companies. 13-15 digits</ResponseField>
        <ResponseField name="primary_email" type="text">**Private Email**<br />
        The private email address of the employee<br />
        Unified field: `private_email`</ResponseField>
        <ResponseField name="secondary_email" type="text">**Secondary Email**</ResponseField>
        <ResponseField name="personal_email" type="text">**Personal Email**</ResponseField>
        <ResponseField name="security_question" type="text">**Security Question**</ResponseField>
        <ResponseField name="security_question_answer" type="text">**Security Question Answer**</ResponseField>
        <ResponseField name="disable_only_login_using_sso" type="text">**Disable Only Login Using SSO**<br />
        Maximum 25 characters</ResponseField>
        <ResponseField name="locale" type="text">**Locale**</ResponseField>
        <ResponseField name="home_phone" type="text">**Home Phone**</ResponseField>
        <ResponseField name="work_phone" type="text">**Work Phone**</ResponseField>
        <ResponseField name="cell_phone" type="text">**Cell Phone**<br />
        The mobile phone number of the employee<br />
        Unified field: `mobile_phone_number`</ResponseField>
        <ResponseField name="primary_phone" type="single_select">**Primary Phone**<br />
        Valid Values: Home Phone, Work Phone, Cell Phone. Abbreviations H, W, C will also be accepted.</ResponseField>
        <ResponseField name="address_1" type="text">**Address 1**<br />
        The street address of the employee<br />
        Unified field: `home_address.street_1`</ResponseField>
        <ResponseField name="address_2" type="text">**Address 2**<br />
        Alternative address <br />
        Unified field: `home_address.street_2`</ResponseField>
        <ResponseField name="address_3" type="text">**Address 3**<br />
        Alternative address </ResponseField>
        <ResponseField name="city" type="text">**City**<br />
        Maximum 25 characters<br />
        Unified field: `home_address.city`</ResponseField>
        <ResponseField name="state" type="text">**State**<br />
        Two character state code (e.g., NJ for New Jersey) or NA for non-USA<br />
        Unified field: `home_address.state`</ResponseField>
        <ResponseField name="zip" type="text">**Zip**<br />
        Valid formats: 11111 or 11111-1111<br />
        Unified field: `home_address.zip_code`</ResponseField>
        <ResponseField name="country" type="text">**Country**<br />
        The uppercase two-letter ISO country (e.g., DE)<br />
        Unified field: `home_address.country`</ResponseField>
        <ResponseField name="address_latitude" type="text">**Address Latitude**</ResponseField>
        <ResponseField name="address_longitude" type="text">**Address Longitude**</ResponseField>
        <ResponseField name="status" type="text">**Status**</ResponseField>
        <ResponseField name="status_external_id" type="text">**Status External Id**</ResponseField>
        <ResponseField name="employee_type" type="text">**Employee Type**</ResponseField>
        <ResponseField name="standard_work_day" type="text">**Standard Work Day**<br />
        Length of standard work day in HH:MM or HH.00 format (e.g., 8:00 or 8.00)</ResponseField>
        <ResponseField name="pay_type" type="text">**Pay Type**</ResponseField>
        <ResponseField name="pay_type_external_id" type="text">**Pay Type External Id**</ResponseField>
        <ResponseField name="default_shift" type="text">**Default Shift**</ResponseField>
        <ResponseField name="medical_eligibility" type="single_select">**Medical Eligibility**</ResponseField>
        <ResponseField name="dental_eligibility" type="single_select">**Dental Eligibility**</ResponseField>
        <ResponseField name="dependent_benefits_eligibility" type="single_select">**Dependent Benefits Eligibility**</ResponseField>
        <ResponseField name="union" type="text">**Union**</ResponseField>
        <ResponseField name="pay_grade" type="text">**Pay Grade**</ResponseField>
        <ResponseField name="step" type="text">**Step**</ResponseField>
        <ResponseField name="hired" type="date" required>**Hired**<br />
        Start date of the employee. Also considered to be the hire date<br />
        Unified field: `start_date`</ResponseField>
        <ResponseField name="started" type="date" required>**Started**</ResponseField>
        <ResponseField name="birthday" type="date">**Birthday**<br />
        The employee's date of birth<br />
        Unified field: `date_of_birth`</ResponseField>
        <ResponseField name="review" type="date">**Review**</ResponseField>
        <ResponseField name="seniority" type="date">**Seniority**</ResponseField>
        <ResponseField name="benefits" type="date">**Benefits**</ResponseField>
        <ResponseField name="terminated" type="date">**Terminated**<br />
        REQUIRED if employee has been terminated</ResponseField>
        <ResponseField name="re_hired" type="date">**Re Hired**</ResponseField>
        <ResponseField name="frozen_benefit" type="date">**Frozen Benefit**</ResponseField>
        <ResponseField name="retirement" type="date">**Retirement**</ResponseField>
        <ResponseField name="custom_date_1" type="date">**Custom Date 1**</ResponseField>
        <ResponseField name="custom_date_2" type="date">**Custom Date 2**</ResponseField>
        <ResponseField name="custom_date_3" type="date">**Custom Date 3**</ResponseField>
        <ResponseField name="custom_date_4" type="date">**Custom Date 4**</ResponseField>
        <ResponseField name="custom_date_5" type="date">**Custom Date 5**</ResponseField>
        <ResponseField name="time_zone" type="text">**Time Zone**</ResponseField>
        <ResponseField name="first_screen" type="text">**First Screen**</ResponseField>
        <ResponseField name="root_cost_center_1" type="text">**Root Cost Center 1**</ResponseField>
        <ResponseField name="root_cost_center_1_effective_from" type="date">**Root Cost Center 1 Effective From**</ResponseField>
        <ResponseField name="root_cost_center_2" type="text">**Root Cost Center 2**</ResponseField>
        <ResponseField name="root_cost_center_2_effective_from" type="date">**Root Cost Center 2 Effective From**</ResponseField>
        <ResponseField name="root_cost_center_3" type="text">**Root Cost Center 3**</ResponseField>
        <ResponseField name="root_cost_center_3_effective_from" type="date">**Root Cost Center 3 Effective From**</ResponseField>
        <ResponseField name="root_cost_center_4" type="text">**Root Cost Center 4**</ResponseField>
        <ResponseField name="root_cost_center_4_effective_from" type="date">**Root Cost Center 4 Effective From**</ResponseField>
        <ResponseField name="root_cost_center_5" type="text">**Root Cost Center 5**</ResponseField>
        <ResponseField name="root_cost_center_5_effective_from" type="date">**Root Cost Center 5 Effective From**</ResponseField>
        <ResponseField name="root_cost_center_6" type="text">**Root Cost Center 6**</ResponseField>
        <ResponseField name="root_cost_center_6_effective_from" type="date">**Root Cost Center 6 Effective From**</ResponseField>
        <ResponseField name="root_cost_center_7" type="text">**Root Cost Center 7**</ResponseField>
        <ResponseField name="root_cost_center_7_effective_from" type="date">**Root Cost Center 7 Effective From**</ResponseField>
        <ResponseField name="root_cost_center_8" type="text">**Root Cost Center 8**</ResponseField>
        <ResponseField name="root_cost_center_8_effective_from" type="date">**Root Cost Center 8 Effective From**</ResponseField>
        <ResponseField name="root_cost_center_9" type="text">**Root Cost Center 9**</ResponseField>
        <ResponseField name="root_cost_center_9_effective_from" type="date">**Root Cost Center 9 Effective From**</ResponseField>
        <ResponseField name="root_cost_center_10" type="text">**Root Cost Center 10**</ResponseField>
        <ResponseField name="root_cost_center_10_effective_from" type="date">**Root Cost Center 10 Effective From**</ResponseField>
        <ResponseField name="limit_cost_center_list_1" type="text">**Limit Cost Center List 1**</ResponseField>
        <ResponseField name="limit_cost_center_list_1_effective_from" type="date">**Limit Cost Center List 1 Effective From**</ResponseField>
        <ResponseField name="limit_cost_center_list_2" type="text">**Limit Cost Center List 2**</ResponseField>
        <ResponseField name="limit_cost_center_list_2_effective_from" type="date">**Limit Cost Center List 2 Effective From**</ResponseField>
        <ResponseField name="limit_cost_center_list_3" type="text">**Limit Cost Center List 3**</ResponseField>
        <ResponseField name="limit_cost_center_list_3_effective_from" type="date">**Limit Cost Center List 3 Effective From**</ResponseField>
        <ResponseField name="limit_cost_center_list_4" type="text">**Limit Cost Center List 4**</ResponseField>
        <ResponseField name="limit_cost_center_list_4_effective_from" type="date">**Limit Cost Center List 4 Effective From**</ResponseField>
        <ResponseField name="limit_cost_center_list_5" type="text">**Limit Cost Center List 5**</ResponseField>
        <ResponseField name="limit_cost_center_list_5_effective_from" type="date">**Limit Cost Center List 5 Effective From**</ResponseField>
        <ResponseField name="limit_cost_center_list_6" type="text">**Limit Cost Center List 6**</ResponseField>
        <ResponseField name="limit_cost_center_list_6_effective_from" type="date">**Limit Cost Center List 6 Effective From**</ResponseField>
        <ResponseField name="limit_cost_center_list_7" type="text">**Limit Cost Center List 7**</ResponseField>
        <ResponseField name="limit_cost_center_list_7_effective_from" type="date">**Limit Cost Center List 7 Effective From**</ResponseField>
        <ResponseField name="limit_cost_center_list_8" type="text">**Limit Cost Center List 8**</ResponseField>
        <ResponseField name="limit_cost_center_list_8_effective_from" type="date">**Limit Cost Center List 8 Effective From**</ResponseField>
        <ResponseField name="limit_cost_center_list_9" type="text">**Limit Cost Center List 9**</ResponseField>
        <ResponseField name="limit_cost_center_list_9_effective_from" type="date">**Limit Cost Center List 9 Effective From**</ResponseField>
        <ResponseField name="limit_cost_center_list_10" type="text">**Limit Cost Center List 10**</ResponseField>
        <ResponseField name="limit_cost_center_list_10_effective_from" type="date">**Limit Cost Center List 10 Effective From**</ResponseField>
        <ResponseField name="default_cost_center_1" type="text">**Default Cost Center 1**</ResponseField>
        <ResponseField name="default_cost_center_2" type="text">**Default Cost Center 2**</ResponseField>
        <ResponseField name="default_cost_center_3" type="text">**Default Cost Center 3**</ResponseField>
        <ResponseField name="default_cost_center_4" type="text">**Default Cost Center 4**</ResponseField>
        <ResponseField name="default_cost_center_5" type="text">**Default Cost Center 5**</ResponseField>
        <ResponseField name="default_cost_center_6" type="text">**Default Cost Center 6**</ResponseField>
        <ResponseField name="default_cost_center_7" type="text">**Default Cost Center 7**</ResponseField>
        <ResponseField name="default_cost_center_8" type="text">**Default Cost Center 8**</ResponseField>
        <ResponseField name="default_cost_center_9" type="text">**Default Cost Center 9**</ResponseField>
        <ResponseField name="default_cost_center_10" type="text">**Default Cost Center 10**</ResponseField>
        <ResponseField name="job_last_changed" type="date">**Job Last Changed**</ResponseField>
        <ResponseField name="access" type="text">**Access**</ResponseField>
        <ResponseField name="access_on_new_only" type="single_select">**Access On New Only**</ResponseField>
        <ResponseField name="accruals" type="text">**Accruals**</ResponseField>
        <ResponseField name="accruals_profile_effective_from" type="date">**Accruals Profile Effective From**</ResponseField>
        <ResponseField name="accruals_on_new_only" type="single_select">**Accruals On New Only**</ResponseField>
        <ResponseField name="attestation_profile" type="text">**Attestation Profile**</ResponseField>
        <ResponseField name="attestation_profile_effective_from" type="date">**Attestation Profile Effective From**</ResponseField>
        <ResponseField name="attestation_profile_on_new_only" type="single_select">**Attestation Profile On New Only**</ResponseField>
        <ResponseField name="beacon_mo_profile" type="text">**Beacon (Mo) Profile**</ResponseField>
        <ResponseField name="beacon_mo_profile_on_new_only" type="single_select">**Beacon (Mo) Profile On New Only**</ResponseField>
        <ResponseField name="benefit_profile" type="text">**Benefit Profile**</ResponseField>
        <ResponseField name="benefit_profile_effective_from" type="date">**Benefit Profile Effective From**</ResponseField>
        <ResponseField name="benefit_profile_on_new_only" type="single_select">**Benefit Profile On New Only**</ResponseField>
        <ResponseField name="competency_profile" type="text">**Competency Profile**</ResponseField>
        <ResponseField name="competency_profile_on_new_only" type="single_select">**Competency Profile On New Only**</ResponseField>
        <ResponseField name="counter_distribution_profile" type="text">**Counter Distribution Profile**</ResponseField>
        <ResponseField name="counter_distribution_profile_effective_from" type="date">**Counter Distribution Profile Effective From**</ResponseField>
        <ResponseField name="counter_distribution_profile_on_new_only" type="single_select">**Counter Distribution Profile On New Only**</ResponseField>
        <ResponseField name="dashboard_layout_profile" type="text">**Dashboard Layout Profile**</ResponseField>
        <ResponseField name="dashboard_layout_profile_effective_from" type="date">**Dashboard Layout Profile Effective From**</ResponseField>
        <ResponseField name="dashboard_layout_profile_on_new_only" type="single_select">**Dashboard Layout Profile On New Only**</ResponseField>
        <ResponseField name="holiday" type="text">**Holiday**</ResponseField>
        <ResponseField name="holiday_on_new_only" type="single_select">**Holiday On New Only**</ResponseField>
        <ResponseField name="intouch_schedule_restrictions_profile" type="text">**InTouch Schedule Restrictions Profile**</ResponseField>
        <ResponseField name="intouch_schedule_restrictions_profile_on_new_only" type="single_select">**InTouch Schedule Restrictions Profile On New Only**</ResponseField>
        <ResponseField name="labor_distribution_profile" type="text">**Labor Distribution Profile**</ResponseField>
        <ResponseField name="labor_distribution_profile_on_new_only" type="single_select">**Labor Distribution Profile On New Only**</ResponseField>
        <ResponseField name="onboarding_profile" type="text">**Onboarding Profile**</ResponseField>
        <ResponseField name="onboarding_profile_on_new_only" type="single_select">**Onboarding Profile On New Only**</ResponseField>
        <ResponseField name="pay_calculations" type="text">**Pay Calculations**</ResponseField>
        <ResponseField name="pay_calculations_profile_effective_from" type="date">**Pay Calculations Profile Effective From**</ResponseField>
        <ResponseField name="pay_calculations_on_new_only" type="single_select">**Pay Calculations On New Only**</ResponseField>
        <ResponseField name="pay_period" type="text">**Pay Period**</ResponseField>
        <ResponseField name="pay_period_on_new_only" type="single_select">**Pay Period On New Only**</ResponseField>
        <ResponseField name="pay_prep" type="text">**Pay Prep**</ResponseField>
        <ResponseField name="pay_prep_on_new_only" type="single_select">**Pay Prep On New Only**</ResponseField>
        <ResponseField name="points_profile" type="text">**Points Profile**</ResponseField>
        <ResponseField name="points_profile_on_new_only" type="single_select">**Points Profile On New Only**</ResponseField>
        <ResponseField name="pst_delivery_policy" type="text">**PST Delivery Policy**</ResponseField>
        <ResponseField name="pst_delivery_policy_on_new_only" type="single_select">**PST Delivery Policy On New Only**</ResponseField>
        <ResponseField name="pst_population_profile" type="text">**PST Population Profile**</ResponseField>
        <ResponseField name="pst_population_profile_on_new_only" type="single_select">**PST Population Profile On New Only**</ResponseField>
        <ResponseField name="retirement_plan" type="text">**Retirement Plan**</ResponseField>
        <ResponseField name="retirement_plan_on_new_only" type="single_select">**Retirement Plan On New Only**</ResponseField>
        <ResponseField name="role" type="text">**Role**</ResponseField>
        <ResponseField name="role_on_new_only" type="single_select">**Role On New Only**</ResponseField>
        <ResponseField name="second_retirement_plan" type="text">**Second Retirement Plan**</ResponseField>
        <ResponseField name="second_retirement_plan_on_new_only" type="single_select">**Second Retirement Plan On New Only**</ResponseField>
        <ResponseField name="employee_perspectives_profile" type="text">**Employee Perspectives Profile**</ResponseField>
        <ResponseField name="employee_perspectives_profile_effective_from" type="date">**Employee Perspectives Profile Effective From**</ResponseField>
        <ResponseField name="employee_perspectives_profile_on_new_only" type="single_select">**Employee Perspectives Profile On New Only**</ResponseField>
        <ResponseField name="work_schedule" type="text">**Work Schedule**</ResponseField>
        <ResponseField name="work_schedule_start_pattern_on" type="date">**Work Schedule Start Pattern On**</ResponseField>
        <ResponseField name="work_schedule_start_pattern_type" type="single_select">**Work Schedule Start Pattern Type**<br />
        REQUIRED if "Schedule Pattern On" is specified. Default Value - "Day" is set if empty or CLEAR.</ResponseField>
        <ResponseField name="work_schedule_on_new_only" type="single_select">**Work Schedule On New Only**</ResponseField>
        <ResponseField name="scheduler" type="text">**Scheduler**</ResponseField>
        <ResponseField name="scheduler_on_new_only" type="single_select">**Scheduler On New Only**</ResponseField>
        <ResponseField name="security" type="text">**Security**</ResponseField>
        <ResponseField name="security_on_new_only" type="single_select">**Security On New Only**</ResponseField>
        <ResponseField name="timesheet" type="text">**Timesheet**</ResponseField>
        <ResponseField name="timesheet_on_new_only" type="single_select">**Timesheet On New Only**</ResponseField>
        <ResponseField name="timesheet_autopopulate" type="text">**Timesheet Autopopulate**</ResponseField>
        <ResponseField name="timesheet_autopopulate_on_new_only" type="single_select">**Timesheet Autopopulate On New Only**</ResponseField>
        <ResponseField name="training_profile" type="text">**Training Profile**</ResponseField>
        <ResponseField name="training_profile_on_new_only" type="single_select">**Training Profile On New Only**</ResponseField>
        <ResponseField name="performance_review_profile" type="text">**Performance Review Profile**</ResponseField>
        <ResponseField name="performance_review_profile_on_new_only" type="single_select">**Performance Review Profile On New Only**</ResponseField>
        <ResponseField name="w2_delivery_policy" type="text">**W2 Delivery Policy**</ResponseField>
        <ResponseField name="w2_delivery_policy_on_new_only" type="single_select">**W2 Delivery Policy On New Only**</ResponseField>
        <ResponseField name="workday_breakdown" type="text">**Workday Breakdown**</ResponseField>
        <ResponseField name="workday_breakdown_profile_effective_from" type="date">**Workday Breakdown Profile Effective From**</ResponseField>
        <ResponseField name="workday_breakdown_on_new_only" type="single_select">**Workday Breakdown On New Only**</ResponseField>
        <ResponseField name="working_time_regulations" type="text">**Working Time Regulations**</ResponseField>
        <ResponseField name="expense_tracking_profile_on_new_only" type="single_select">**Expense Tracking Profile On New Only**</ResponseField>
        <ResponseField name="expense_tracking_profile" type="text">**Expense Tracking Profile**</ResponseField>
        <ResponseField name="data_retention_profile" type="text">**Data Retention Profile**</ResponseField>
        <ResponseField name="data_retention_profile_effective_from" type="date">**Data Retention Profile Effective From**</ResponseField>
        <ResponseField name="data_retention_profile_on_new_only" type="single_select">**Data Retention Profile On New Only**</ResponseField>
        <ResponseField name="hardware_rsi_hand_template" type="text">**Hardware RSI Hand Template**</ResponseField>
        <ResponseField name="hardware_asher_pin" type="text">**Hardware Asher PIN**</ResponseField>
        <ResponseField name="hardware_zk_password" type="text">**Hardware ZK Password**</ResponseField>
        <ResponseField name="hardware_ats_pin" type="text">**Hardware ATS PIN**</ResponseField>
        <ResponseField name="hardware_ats_security_level" type="text">**Hardware ATS Security Level**</ResponseField>
        <ResponseField name="hardware_intouch_pin" type="text">**Hardware InTouch PIN**</ResponseField>
        <ResponseField name="hardware_intouch_security_level" type="single_select">**Hardware InTouch Security Level**</ResponseField>
        <ResponseField name="gender" type="single_select">**Gender**<br />
        The gender of the employee<br />
        Unified field: `gender`</ResponseField>
        <ResponseField name="eye_color" type="text">**Eye Color**</ResponseField>
        <ResponseField name="height" type="text">**Height**</ResponseField>
        <ResponseField name="disability" type="single_select">**Disability**</ResponseField>
        <ResponseField name="citizenship" type="single_select">**Citizenship**</ResponseField>
        <ResponseField name="ethnicity" type="single_select">**Ethnicity**</ResponseField>
        <ResponseField name="eeo_classification" type="single_select">**EEO Classification**</ResponseField>
        <ResponseField name="eeo_4_classification" type="single_select">**EEO-4 Classification**</ResponseField>
        <ResponseField name="eeo_4_function" type="single_select">**EEO-4 Function**</ResponseField>
        <ResponseField name="primary_language" type="text">**Primary Language**</ResponseField>
        <ResponseField name="secondary_language" type="text">**Secondary Language**</ResponseField>
        <ResponseField name="smoker" type="single_select">**Smoker**</ResponseField>
        <ResponseField name="seasonal" type="single_select">**Seasonal**</ResponseField>
        <ResponseField name="ft_student" type="single_select">**FT Student**</ResponseField>
        <ResponseField name="referral" type="text">**Referral**</ResponseField>
        <ResponseField name="visa_type" type="single_select">**Visa Type**</ResponseField>
        <ResponseField name="recruiter" type="text">**Recruiter**</ResponseField>
        <ResponseField name="worker_type" type="text">**Worker Type**</ResponseField>
        <ResponseField name="manager_1" type="text">**Manager 1**</ResponseField>
        <ResponseField name="manager_1_ein_tax_id" type="text">**Manager 1 EIN Tax Id**</ResponseField>
        <ResponseField name="manager_1_ein_name" type="text">**Manager 1 EIN Name**</ResponseField>
        <ResponseField name="manager_2" type="text">**Manager 2**</ResponseField>
        <ResponseField name="manager_2_ein_tax_id" type="text">**Manager 2 EIN Tax Id**</ResponseField>
        <ResponseField name="manager_2_ein_name" type="text">**Manager 2 EIN Name**</ResponseField>
        <ResponseField name="manager_3" type="text">**Manager 3**</ResponseField>
        <ResponseField name="manager_3_ein_tax_id" type="text">**Manager 3 EIN Tax Id**</ResponseField>
        <ResponseField name="manager_3_ein_name" type="text">**Manager 3 EIN Name**</ResponseField>
        <ResponseField name="manager_4" type="text">**Manager 4**</ResponseField>
        <ResponseField name="manager_4_ein_tax_id" type="text">**Manager 4 EIN Tax Id**</ResponseField>
        <ResponseField name="manager_4_ein_name" type="text">**Manager 4 EIN Name**</ResponseField>
        <ResponseField name="manager_5" type="text">**Manager 5**</ResponseField>
        <ResponseField name="manager_5_ein_tax_id" type="text">**Manager 5 EIN Tax Id**</ResponseField>
        <ResponseField name="manager_5_ein_name" type="text">**Manager 5 EIN Name**</ResponseField>
        <ResponseField name="manager_6" type="text">**Manager 6**</ResponseField>
        <ResponseField name="manager_6_ein_tax_id" type="text">**Manager 6 EIN Tax Id**</ResponseField>
        <ResponseField name="manager_6_ein_name" type="text">**Manager 6 EIN Name**</ResponseField>
        <ResponseField name="managed_cost_centers_enabled" type="single_select">**Managed Cost Centers Enabled**</ResponseField>
        <ResponseField name="managed_cost_centers_allow_save_of_other_cost_centers" type="single_select">**Managed Cost Centers Allow Save Of Other Cost Centers**</ResponseField>
        <ResponseField name="managed_cost_centers_restrict_editing_approved_timesheets" type="single_select">**Managed Cost Centers Restrict Editing Approved Timesheets**</ResponseField>
        <ResponseField name="time_entry_extra_1" type="text">**Time Entry Extra 1**</ResponseField>
        <ResponseField name="time_entry_extra_2" type="text">**Time Entry Extra 2**</ResponseField>
        <ResponseField name="time_entry_extra_3" type="text">**Time Entry Extra 3**</ResponseField>
        <ResponseField name="time_entry_extra_4" type="text">**Time Entry Extra 4**</ResponseField>
        <ResponseField name="time_entry_extra_5" type="text">**Time Entry Extra 5**</ResponseField>
        <ResponseField name="account_extra_1" type="text">**Account Extra 1**<br />
        Additional employee attributes - Maximum 255 characters</ResponseField>
        <ResponseField name="account_extra_2" type="text">**Account Extra 2**<br />
        Additional employee attributes - Maximum 255 characters</ResponseField>
        <ResponseField name="account_extra_3" type="text">**Account Extra 3**<br />
        Additional employee attributes - Maximum 255 characters</ResponseField>
        <ResponseField name="account_extra_4" type="text">**Account Extra 4**<br />
        Additional employee attributes - Maximum 255 characters</ResponseField>
        <ResponseField name="account_extra_5" type="text">**Account Extra 5**<br />
        Additional employee attributes - Maximum 255 characters</ResponseField>
        <ResponseField name="account_extra_1_effective_from" type="date">**Account Extra 1 Effective From**</ResponseField>
        <ResponseField name="account_extra_2_effective_from" type="date">**Account Extra 2 Effective From**</ResponseField>
        <ResponseField name="account_extra_3_effective_from" type="date">**Account Extra 3 Effective From**</ResponseField>
        <ResponseField name="account_extra_4_effective_from" type="date">**Account Extra 4 Effective From**</ResponseField>
        <ResponseField name="account_extra_5_effective_from" type="date">**Account Extra 5 Effective From**</ResponseField>
        <ResponseField name="account_extra_mode" type="single_select">**Account Extra Mode**<br />
        Controls whether account extra field entries are added as new records (ADD) or overwrite existing (SET). Default: ADD</ResponseField>
        <ResponseField name="rate_x_base" type="text">**Rate X Base**</ResponseField>
        <ResponseField name="rate_x_base_eff_date" type="date">**Rate X Base Eff Date**</ResponseField>
        <ResponseField name="rate_x_table" type="text">**Rate X Table**</ResponseField>
        <ResponseField name="rate_x_ext_z_table" type="text">**Rate X Ext Z Table**</ResponseField>
        <ResponseField name="rate_x_ext_z_type" type="text">**Rate X Ext Z Type**</ResponseField>
        <ResponseField name="base_compensation" type="text">**Base Compensation**</ResponseField>
        <ResponseField name="base_compensation_type" type="single_select">**Base Compensation Type**</ResponseField>
        <ResponseField name="base_compensation_amount_earning_code" type="text">**Base Compensation Amount Earning Code**</ResponseField>
        <ResponseField name="base_compensation_hours_earning_code" type="text">**Base Compensation Hours Earning Code**</ResponseField>
        <ResponseField name="base_compensation_effective_from" type="date">**Base Compensation Effective From**</ResponseField>
        <ResponseField name="autopay_schedule" type="text">**Autopay Schedule**</ResponseField>
        <ResponseField name="autopay_schedule_effective_from" type="date">**Autopay Schedule Effective From**</ResponseField>
        <ResponseField name="emergency_contact_first_name" type="text">**Emergency Contact First Name**</ResponseField>
        <ResponseField name="emergency_contact_last_name" type="text">**Emergency Contact Last Name**</ResponseField>
        <ResponseField name="emergency_contact_relationship" type="text">**Emergency Contact Relationship**<br />
        REQUIRED if any Emergency Contact fields are defined (unless disabled in company settings)</ResponseField>
        <ResponseField name="emergency_contact_work_phone" type="text">**Emergency Contact Work Phone**</ResponseField>
        <ResponseField name="emergency_contact_home_phone" type="text">**Emergency Contact Home Phone**</ResponseField>
        <ResponseField name="emergency_contact_cell_phone" type="text">**Emergency Contact Cell Phone**</ResponseField>
        <ResponseField name="emergency_contact_address_1" type="text">**Emergency Contact Address 1**</ResponseField>
        <ResponseField name="emergency_contact_address_2" type="text">**Emergency Contact Address 2**</ResponseField>
        <ResponseField name="emergency_contact_address_3" type="text">**Emergency Contact Address 3**</ResponseField>
        <ResponseField name="emergency_contact_city" type="text">**Emergency Contact City**</ResponseField>
        <ResponseField name="emergency_contact_state" type="text">**Emergency Contact State**</ResponseField>
        <ResponseField name="emergency_contact_zip" type="text">**Emergency Contact Zip**</ResponseField>
        <ResponseField name="emergency_contact_country" type="text">**Emergency Contact Country**</ResponseField>
        <ResponseField name="accruals_x_def" type="text">**Accruals X Def**</ResponseField>
        <ResponseField name="accruals_x_hrs" type="text">**Accruals X Hrs**</ResponseField>
        <ResponseField name="last_pay_period_end_date" type="date">**Last Pay Period End Date**</ResponseField>
        <ResponseField name="default_workers_comp_code" type="text">**Default Workers Comp Code**</ResponseField>
        <ResponseField name="default_workers_comp_code_on_new_only" type="single_select">**Default Workers Comp Code On New Only**</ResponseField>
        <ResponseField name="is_w2" type="single_select">**Is W2**</ResponseField>
        <ResponseField name="is_1099" type="single_select">**Is 1099**</ResponseField>
        <ResponseField name="is_draw" type="single_select">**Is Draw**</ResponseField>
        <ResponseField name="reciprocity_override" type="text">**Reciprocity Override**</ResponseField>
        <ResponseField name="is_commission_only_canada" type="single_select">**Is Commission Only (Canada)**</ResponseField>
        <ResponseField name="add_to_new_hire_export" type="text">**Add To New Hire Export**</ResponseField>
        <ResponseField name="add_to_new_hire_export_on_new_only" type="single_select">**Add To New Hire Export On New Only**</ResponseField>
        <ResponseField name="actual_marital_status" type="text">**Actual Marital Status**</ResponseField>
        <ResponseField name="hr_action_history_type" type="text">**HR Action History Type**</ResponseField>
      </Tab>

      <Tab title="v2">
        <Info>
          Some **optional** form fields are referencing the following data models:

          * Employees

          Consider enabling these in your [scope configuration](/hris/features/scopes).
        </Info>

        <ResponseField name="username" type="text" required>**Username**<br />
        The username for the employee.</ResponseField>
        <ResponseField name="first_name" type="text" required>**First Name**<br />
        The first name of the employee<br />
        Unified field: `first_name`</ResponseField>
        <ResponseField name="last_name" type="text" required>**Last Name**<br />
        The last name of the employee<br />
        Unified field: `last_name`</ResponseField>
        <ResponseField name="middle_name" type="text">**Middle Name**</ResponseField>
        <ResponseField name="nickname" type="text">**Nickname (Preferred Name)**</ResponseField>
        <ResponseField name="primary_email" type="text">**Private Email**<br />
        The private email address of the employee<br />
        Unified field: `private_email`</ResponseField>
        <ResponseField name="secondary_email" type="text">**Secondary Email**</ResponseField>
        <ResponseField name="employee_id" type="text">**Employee ID**<br />
        External Employee ID</ResponseField>

        <ResponseField name="address" type="object">
          **Home Address**

          <Expandable title="properties">
            <ResponseField name="country" type="text" required>**Country**<br />
            The country of the employee. Use the ISO 3166-1 alpha-3 code.</ResponseField>
            <ResponseField name="address_line_1" type="text">**Street 1**<br />
            The street address of the employee<br />
            Unified field: `home_address.street_1`</ResponseField>
            <ResponseField name="address_line_2" type="text">**Street 2**<br />
            The street address of the employee<br />
            Unified field: `home_address.street_2`</ResponseField>
            <ResponseField name="city" type="text">**City**<br />
            The city of the employee<br />
            Unified field: `home_address.city`</ResponseField>
            <ResponseField name="state" type="text">**State**<br />
            State/Province (Max 3 characters). Only for supported Countries.<br />
            Unified field: `home_address.state`</ResponseField>
            <ResponseField name="zip" type="text">**ZIP Code**<br />
            The ZIP code of the employee<br />
            Unified field: `home_address.zip_code`</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="phones" type="object">
          **Phone Numbers**

          <Expandable title="properties">
            <ResponseField name="cell_phone" type="text">**Mobile Phone Number**<br />
            The mobile phone number of the employee<br />
            Unified field: `mobile_phone_number`</ResponseField>
            <ResponseField name="home_phone" type="text">**Home Phone**</ResponseField>
            <ResponseField name="work_phone" type="text">**Work Phone**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="managers" type="multi_select">**Managers**<br />
        The managers for the employee.</ResponseField>
        <ResponseField name="national_insurance" type="text">**National Insurance Number**</ResponseField>
        <ResponseField name="social_insurance" type="text">**Social Insurance Number**</ResponseField>
        <ResponseField name="social_security" type="text">**Social Security Number**</ResponseField>
        <ResponseField name="add_to_new_hire_export" type="checkbox">**Add to New Hire Export**</ResponseField>

        <ResponseField name="dates" type="object" required>
          **Important Dates**

          <Expandable title="properties">
            <ResponseField name="started" type="date" required>**Start Date**<br />
            Start date of the employee. Also considered to be the hire date<br />
            Unified field: `start_date`</ResponseField>
            <ResponseField name="birthday" type="date">**Date of Birth**<br />
            The employee's date of birth<br />
            Unified field: `date_of_birth`</ResponseField>
            <ResponseField name="hired" type="date" required>**Hired Date**</ResponseField>
            <ResponseField name="re_hired" type="date">**Re-Hired Date**</ResponseField>
            <ResponseField name="terminated" type="date">**Terminated Date**</ResponseField>
          </Expandable>
        </ResponseField>
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** UKG Ready

For **UKG Ready**, we also offer the following other connector variants:

<CardGroup cols={2}>
  <Card title="UKG Ready ATS" icon="https://storage.googleapis.com/kombo-assets/integrations/ukgready/icon.svg" href="/ats/connectors/ukgready">
    UKG Ready for the ATS category
  </Card>
</CardGroup>
