> ## 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 Pro HRIS Integration

> UKG Pro connector for Kombo's HRIS API

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

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

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/23900772792721-UKG-Pro-HRIS-How-do-I-link-my-account">
    Step-by-step instructions to connect your UKG Pro 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="Work Locations">
      | 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            |       |
      | nationality           |       |
      | job\_title            |       |
      | work\_email           |       |
      | personal\_email       |       |
      | mobile\_phone\_number |       |
      | ssn                   |       |
      | gender                |       |
      | ethnicity             |       |
      | marital\_status       |       |
      | employment\_status    |       |
      | employment\_type      |       |
      | weekly\_hours         |       |
      | work\_location\_id    |       |
      | legal\_entity\_id     |       |
      | manager\_id           |       |
      | home\_address         |       |
      | bank\_accounts        |       |
      | date\_of\_birth       |       |
      | start\_date           |       |
      | termination\_date     |       |
      | remote\_created\_at   |       |
      | custom\_fields        |       |
      | integration\_fields   |       |
      | remote\_data          |       |
    </Accordion>

    <Accordion title="Absence Types">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | unit                |       |
      | remote\_data        |       |
    </Accordion>

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

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

    <Accordion title="Time Off Balances">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | type\_id            |       |
      | balance             |       |
      | balance\_unit       |       |
      | used                |       |
      | used\_unit          |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Staffing entities">
      | Field                | Notes |
      | -------------------- | ----- |
      | id                   |       |
      | remote\_id           |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
      | name                 |       |
      | model\_type          |       |
      | description          |       |
      | status               |       |
      | employment\_types    |       |
      | number\_of\_openings |       |
      | parent\_id           |       |
      | remote\_url          |       |
      | remote\_created\_at  |       |
      | remote\_updated\_at  |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | remote\_data         |       |
    </Accordion>

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

    <Accordion title="Staffing Entity <> Location">
      | Field                | Notes |
      | -------------------- | ----- |
      | staffing\_entity\_id |       |
      | location\_id         |       |
      | id                   |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
    </Accordion>

    <Accordion title="Staffing Entity <> Legal Entity">
      | Field                | Notes |
      | -------------------- | ----- |
      | staffing\_entity\_id |       |
      | legal\_entity\_id    |       |
      | id                   |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
    </Accordion>

    <Accordion title="Staffing entity <> Group">
      | Field                | Notes |
      | -------------------- | ----- |
      | staffing\_entity\_id |       |
      | group\_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      |       |
    | Create credentials    |       |
    | API Passthrough       |       |
    | Scope Testing         |       |
    | Per Model Tests       |       |
    | Group Types           |       |
    | TEAM                  |       |
    | DEPARTMENT            |       |
    | Custom Field Explorer |       |
    | Employments           |       |
  </Tab>

  <Tab title="Create Employee with Form">
    <Note>
      The behavior of this action depends on your UKG Pro configuration. If you selected UKG Onboarding during setup, it will create a "New Hire" that needs to be onboarded. If you selected UKG Pro, it will create an employee directly in the system. For this option, you can only create employees for US Companies. If you need to create them for Canadian or Global companies, please contact support
    </Note>

    This integration supports multiple employee creation forms for different use cases:

    <Tabs>
      <Tab title="import-tool">
        <Info>
          Some **optional** form fields are referencing the following data models:

          * Employees

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

        <Info>
          **Form-specific constraints**

          * Creates an employee directly in UKG Pro using the Import Tool API
        </Info>

        <ResponseField name="KeyFields" type="object" required>
          **Key Fields**

          <Expandable title="properties">
            <ResponseField name="CompanyCode" type="single_select" required>**Company**<br />
            Unified field: `legal_entity_id`</ResponseField>
            <ResponseField name="EffectiveDate" type="date">**Effective Date**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="Personal" type="object" required>
          **Personal Information**

          <Expandable title="properties">
            <ResponseField name="NameFirst" type="text" required>**First Name**<br />
            Unified field: `first_name`</ResponseField>
            <ResponseField name="NameLast" type="text" required>**Last Name**<br />
            Unified field: `last_name`</ResponseField>
            <ResponseField name="NameMiddle" type="text">**Middle Name**</ResponseField>
            <ResponseField name="NamePreferred" type="text">**Preferred Name**</ResponseField>
            <ResponseField name="NameFormer" type="text">**Former Name**</ResponseField>
            <ResponseField name="NamePrefixCode" type="single_select">**Name Prefix**</ResponseField>
            <ResponseField name="NameSuffixCode" type="single_select">**Name Suffix**</ResponseField>
            <ResponseField name="GenderCode" type="single_select" required>**Gender**<br />
            Unified field: `gender`</ResponseField>
            <ResponseField name="DateOfBirth" type="date" required>**Date of Birth**<br />
            Unified field: `date_of_birth`</ResponseField>
            <ResponseField name="MaritalStatusCode" type="single_select">**Marital Status**</ResponseField>
            <ResponseField name="PhoneHomeNumber" type="text">**Home Phone**</ResponseField>
            <ResponseField name="PhoneBusinessNumber" type="text">**Business Phone**</ResponseField>
            <ResponseField name="PhoneBusinessExtension" type="text">**Business Phone Extension**</ResponseField>
            <ResponseField name="PhoneOtherNumber" type="text">**Other Phone**</ResponseField>
            <ResponseField name="PhoneOtherTypeCode" type="text">**Other Phone Type**</ResponseField>
            <ResponseField name="AddressEmail" type="text">**Email Address**<br />
            Unified field: `private_email`</ResponseField>
            <ResponseField name="AlternateEmail" type="text">**Alternate Email**</ResponseField>
            <ResponseField name="MailStop" type="text">**Mail Stop**</ResponseField>
            <ResponseField name="PreferredLanguageForPayStatement" type="text">**Preferred Language For Pay Statement**</ResponseField>
            <ResponseField name="EthnicId" type="text">**Ethnic ID**</ResponseField>

            <ResponseField name="Ethnicity" type="text" />

            <ResponseField name="IsAboriginal" type="single_select">**Is Aboriginal**</ResponseField>
            <ResponseField name="IsVisibleMinority" type="single_select">**Is Visible Minority**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="PrimaryAddress" type="object" required>
          **Primary Address**

          <Expandable title="properties">
            <ResponseField name="AddressLine1" type="text">**Address Line 1**<br />
            Unified field: `home_address.street_1`</ResponseField>
            <ResponseField name="AddressLine2" type="text">**Address Line 2**<br />
            Unified field: `home_address.street_2`</ResponseField>
            <ResponseField name="AddressCity" type="text">**City**<br />
            Unified field: `home_address.city`</ResponseField>
            <ResponseField name="AddressStateCode" type="text" required>**State/Province**<br />
            Unified field: `home_address.state`</ResponseField>
            <ResponseField name="AddressCountryCode" type="text">**Country**<br />
            Unified field: `home_address.country`</ResponseField>
            <ResponseField name="AddressZipCode" type="text">**Zip/Postal Code**<br />
            Unified field: `home_address.zip_code`</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="Status" type="object" required>
          **Status Information**

          <Expandable title="properties">
            <ResponseField name="DateOfLastHire" type="date" required>**Date of Last Hire**<br />
            Unified field: `start_date`</ResponseField>
            <ResponseField name="DateOfOriginalHire" type="date">**Date of Original Hire**</ResponseField>
            <ResponseField name="DateOfSeniority" type="date">**Date of Seniority**</ResponseField>
            <ResponseField name="DateOfBenefitSeniority" type="date">**Date of Benefit Seniority**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="JobInformation" type="object" required>
          **Job Information**

          <Expandable title="properties">
            <ResponseField name="JobCode" type="single_select" required>**Job Code**</ResponseField>
            <ResponseField name="LocationCode" type="single_select" required>**Location Code**<br />
            Unified field: `location_id`</ResponseField>
            <ResponseField name="PayGroup" type="single_select" required>**Pay Group**</ResponseField>
            <ResponseField name="PayScaleCode" type="single_select">**Pay Scale Code**</ResponseField>
            <ResponseField name="EmployeeTypeCode" type="single_select" required>**Employee Type**</ResponseField>
            <ResponseField name="FullOrPartTimeCode" type="single_select" required>**Full or Part Time**</ResponseField>
            <ResponseField name="SalaryOrHourly" type="single_select" required>**Salary or Hourly**</ResponseField>
            <ResponseField name="HourlyPayRate" type="number">**Hourly Pay Rate**</ResponseField>
            <ResponseField name="AnnualSalary" type="number">**Annual Salary**<br />
            Unified field: `yearly_salary`</ResponseField>
            <ResponseField name="ScheduledWorkHours" type="number" required>**Scheduled Work Hours**</ResponseField>
            <ResponseField name="SupervisorId" type="single_select">**Supervisor ID**<br />
            References `/v1/hris/employees?remote_model=employee`</ResponseField>
            <ResponseField name="EarningsGroupCode" type="single_select" required>**Earnings Group Code**</ResponseField>
            <ResponseField name="BenefitGroupCode" type="single_select" required>**Benefit Group Code**</ResponseField>
            <ResponseField name="JobGrpCode" type="single_select">**Job Group**</ResponseField>
            <ResponseField name="IsAutopaid" type="single_select">**Pay Automatically**</ResponseField>
            <ResponseField name="OrgLevel1Code" type="single_select">**Org Level 1 Code**</ResponseField>
            <ResponseField name="OrgLevel2Code" type="single_select">**Org Level 2 Code**</ResponseField>
            <ResponseField name="OrgLevel3Code" type="single_select">**Org Level 3 Code**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="USTaxes" type="object">
          **US Taxes**

          <Expandable title="properties">
            <ResponseField name="FederalFilingStatusCode" type="text">**Federal Filing Status Code**</ResponseField>
            <ResponseField name="FederalTotalAllowances" type="number">**Federal Total Allowances**</ResponseField>
            <ResponseField name="FederalAdditionalAmountWithheld" type="number">**Federal Additional Amount Withheld**</ResponseField>
            <ResponseField name="FederalDeductionAmount" type="number">**Federal Deduction Amount**</ResponseField>
            <ResponseField name="FederalEmployeeClaimsExemption" type="single_select">**Federal Employee Claims Exemption**</ResponseField>
            <ResponseField name="WorkInStateTaxPlan" type="single_select">**State Unemployment Tax Plan**</ResponseField>
            <ResponseField name="WorkInFilingStatusCode" type="text">**Work In Filing Status Code**</ResponseField>
            <ResponseField name="WorkInTotalAllowancesClaimed" type="number">**Work In Total Allowances Claimed**</ResponseField>
            <ResponseField name="WorkInDeductionAmount" type="number">**Work In Deduction Amount**</ResponseField>
            <ResponseField name="WorkInEmployeeClaimsExemption" type="single_select">**Work In Employee Claims Exemption**</ResponseField>
            <ResponseField name="WorkInAdditionalAmountWithheld" type="number">**Work In Additional Amount Withheld**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="ID" type="object" required>
          **Identification**

          <Expandable title="properties">
            <ResponseField name="SSN" type="text" required>**Social Security Number**</ResponseField>
            <ResponseField name="EmployeeNumber" type="text">**Employee Number**</ResponseField>
            <ResponseField name="NationalID" type="text">**National ID**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="PrivateInfo" type="object">
          **Private Information**

          <Expandable title="properties">
            <ResponseField name="BirthCountryCode" type="text">**Birth Country Code**<br />
            Unified field: `nationality`</ResponseField>
            <ResponseField name="BirthLocation" type="text">**Birth Location**</ResponseField>
            <ResponseField name="DisabilityType" type="text">**Disability Type**</ResponseField>
            <ResponseField name="IsVeteran" type="single_select">**Is Veteran**</ResponseField>
            <ResponseField name="IsDisabled" type="single_select">**Is Disabled**</ResponseField>
            <ResponseField name="MilitaryBranchCode" type="single_select">**Military Branch Code**</ResponseField>
            <ResponseField name="MilitaryEraCode" type="single_select">**Military Era Code**</ResponseField>
            <ResponseField name="MilitaryIsDisabledVet" type="single_select">**Is Disabled Veteran**</ResponseField>
            <ResponseField name="MilitaryIsMedalVet" type="single_select">**Is Medal Veteran**</ResponseField>
            <ResponseField name="MilitarySeparationDate" type="date">**Military Separation Date**</ResponseField>
            <ResponseField name="MilitaryIsActiveWartimeVet" type="single_select">**Is Active Wartime Veteran**</ResponseField>
            <ResponseField name="NationalIDExpireDate" type="date">**National ID Expiration Date**</ResponseField>
            <ResponseField name="Nationality1Code" type="text">**Primary Nationality Code**<br />
            Unified field: `nationality`</ResponseField>
            <ResponseField name="Nationality2Code" type="text">**Secondary Nationality Code**</ResponseField>
            <ResponseField name="Nationality3Code" type="text">**Tertiary Nationality Code**</ResponseField>

            <ResponseField name="Smoker" type="single_select" />

            <ResponseField name="WorkPermitCountry" type="text">**Work Permit Country**</ResponseField>
            <ResponseField name="WorkPermitRefID" type="text">**Work Permit Reference ID**</ResponseField>
            <ResponseField name="WorkPermitApplicationDate" type="date">**Work Permit Application Date**</ResponseField>
            <ResponseField name="WorkPermitApprovalDate" type="date">**Work Permit Approval Date**</ResponseField>
            <ResponseField name="WorkPermitExpirationDate" type="date">**Work Permit Expiration Date**</ResponseField>
            <ResponseField name="IsPensioner" type="single_select">**Is Pensioner**</ResponseField>
            <ResponseField name="I9VisaType" type="text">**I9 Visa Type**</ResponseField>
            <ResponseField name="I9ExpirationDate" type="date">**I9 Expiration Date**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="I9" type="object">
          **I-9 Employment Eligibility**

          <Expandable title="properties">
            <ResponseField name="I9VerifiedCode" type="text">**I9 Verified Code**</ResponseField>
            <ResponseField name="I9DocumentNumber" type="text">**I9 Document Number**</ResponseField>
            <ResponseField name="I9ExpirationDate" type="date">**I9 Expiration Date**</ResponseField>
            <ResponseField name="I9DocACode" type="text">**I9 Document A Code**</ResponseField>
            <ResponseField name="I9DocBCode" type="text">**I9 Document B Code**</ResponseField>
            <ResponseField name="I9DocCCode" type="text">**I9 Document C Code**</ResponseField>
            <ResponseField name="I9WorkAuthorization" type="text">**I9 Work Authorization**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="DirectDeposit" type="object">
          **Direct Deposit Information**

          <Expandable title="properties">
            <ResponseField name="DDAccountNumber" type="text" required>**Account Number**</ResponseField>
            <ResponseField name="DDAccountIsInactive" type="single_select">**Account Is Inactive**</ResponseField>
            <ResponseField name="DDAmountOrPercentage" type="number">**Amount or Percentage**</ResponseField>
            <ResponseField name="DDAccountTypeCode" type="single_select">**Account Type**</ResponseField>
            <ResponseField name="DDRoutingNumber" type="text" required>**Routing Number**</ResponseField>
            <ResponseField name="DDBankName" type="text">**Bank Name**</ResponseField>
            <ResponseField name="DDDepositRuleCode" type="single_select" required>**Deposit Rule**</ResponseField>
            <ResponseField name="DDInstitutionNo" type="text">**Institution Number**</ResponseField>
            <ResponseField name="DDIsPreNote" type="single_select">**Is Pre-Note**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="Contacts" type="object">
          **Emergency Contacts & Dependents**

          <Expandable title="properties">
            <ResponseField name="ContactDetail" type="object">
              **Contact Information**

              <Expandable title="properties">
                <ResponseField name="ConNameFirst" type="text" required>**First Name**</ResponseField>
                <ResponseField name="ConNameLast" type="text" required>**Last Name**</ResponseField>
                <ResponseField name="ConNameMiddle" type="text">**Middle Name**</ResponseField>
                <ResponseField name="ConNameFormer" type="text">**Former Name**</ResponseField>
                <ResponseField name="ConNameSuffixCode" type="single_select">**Name Suffix**</ResponseField>
                <ResponseField name="ConRelationshipCode" type="single_select" required>**Relationship Code**</ResponseField>
                <ResponseField name="ConDateOfBirth" type="date">**Date of Birth**</ResponseField>
                <ResponseField name="ConGender" type="single_select">**Gender**</ResponseField>
                <ResponseField name="ConSSN" type="text">**SSN**</ResponseField>
                <ResponseField name="ConNationalID" type="text">**National ID**</ResponseField>
                <ResponseField name="ConIsEmergencyContact" type="single_select">**Is Emergency Contact**</ResponseField>
                <ResponseField name="ConIsDependent" type="single_select">**Is Dependent**</ResponseField>
                <ResponseField name="ConIsBeneficiary" type="single_select">**Is Beneficiary**</ResponseField>
                <ResponseField name="ConIsActive" type="checkbox">**Is Active**</ResponseField>
                <ResponseField name="ConPhoneHomeNumberCountryCode" type="single_select">**Home Phone Country Code**</ResponseField>
                <ResponseField name="ConPhoneHomeNumber" type="text">**Home Phone**</ResponseField>
                <ResponseField name="ConPhoneWorkNumber" type="text">**Work Phone**</ResponseField>
                <ResponseField name="ConPhoneWorkNumberCountryCode" type="single_select">**Work Phone Country Code**</ResponseField>
                <ResponseField name="ConPhoneWorkExtension" type="text">**Work Phone Extension**</ResponseField>
                <ResponseField name="ConPhonePreferred" type="single_select">**Preferred Phone**</ResponseField>
                <ResponseField name="ConEmail" type="text">**Email**</ResponseField>
                <ResponseField name="ConIsDifferentAddress" type="single_select" required>**Has Different Address**</ResponseField>
                <ResponseField name="ConAddressLine1" type="text">**Address Line 1**</ResponseField>
                <ResponseField name="ConAddressLine2" type="text">**Address Line 2**</ResponseField>
                <ResponseField name="ConAddressCity" type="text">**City**</ResponseField>
                <ResponseField name="ConAddressStateCode" type="text">**State/Province**</ResponseField>
                <ResponseField name="ConAddressCountryCode" type="text">**Country**</ResponseField>
                <ResponseField name="ConAddressZipCode" type="text">**Zip/Postal Code**</ResponseField>
              </Expandable>
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Tab>

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

          * Employees
          * Legal Entities

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

        <Info>
          **Form-specific constraints**

          * Creates a new hire in UKG Onboarding that will go through the onboarding process
        </Info>

        <ResponseField name="contactInformation" type="object" required>
          **Contact Information**<br />
          Contact information for the new hire

          <Expandable title="properties">
            <ResponseField name="name" type="object" required>
              **Name**<br />
              The name of the new hire

              <Expandable title="properties">
                <ResponseField name="first" type="text" required>**First Name**<br />
                The first name of the new hire<br />
                Unified field: `first_name`</ResponseField>
                <ResponseField name="middle" type="text">**Middle Name**<br />
                The middle name of the new hire</ResponseField>
                <ResponseField name="last" type="text" required>**Last Name**<br />
                The last name of the new hire<br />
                Unified field: `last_name`</ResponseField>
                <ResponseField name="formerLast" type="text">**Former Last Name**<br />
                The former last name of the new hire</ResponseField>
                <ResponseField name="preferredFirst" type="text">**Preferred First Name**<br />
                The preferred first name of the new hire</ResponseField>
              </Expandable>
            </ResponseField>

            <ResponseField name="emailAddress" type="text" required>**Email Address**<br />
            The email address of the new hire<br />
            Unified field: `private_email`</ResponseField>
            <ResponseField name="primaryPhone" type="text" required>**Primary Phone**<br />
            The primary phone number of the new hire<br />
            Unified field: `mobile_phone_number`</ResponseField>
            <ResponseField name="secondaryPhone" type="text">**Secondary Phone**<br />
            The secondary phone number of the new hire</ResponseField>

            <ResponseField name="address" type="object">
              **Address**<br />
              The address of the new hire

              <Expandable title="properties">
                <ResponseField name="line1" type="text">**Street 1**<br />
                The street address of the new hire<br />
                Unified field: `home_address.street_1`</ResponseField>
                <ResponseField name="line2" type="text">**Street 2**<br />
                The street address of the new hire<br />
                Unified field: `home_address.street_2`</ResponseField>
                <ResponseField name="city" type="text">**City**<br />
                The city of the new hire<br />
                Unified field: `home_address.city`</ResponseField>
                <ResponseField name="postalCode" type="text">**Postal Code**<br />
                The postal code of the new hire<br />
                Unified field: `home_address.zip_code`</ResponseField>
                <ResponseField name="stateCode" type="text">**State Code**<br />
                The state code of the new hire<br />
                Unified field: `home_address.state`</ResponseField>
                <ResponseField name="country" type="text">**Country**<br />
                The country of the new hire<br />
                Unified field: `home_address.country`</ResponseField>
                <ResponseField name="countryCode" type="single_select">**Country Code**<br />
                ISO country code of the address</ResponseField>
              </Expandable>
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="job" type="object">
          **Job**<br />
          The job information for the new hire

          <Expandable title="properties">
            <ResponseField name="code" type="single_select">**Job Code**<br />
            UKG Pro job code<br />
            Unified field: `job_title`</ResponseField>
            <ResponseField name="requisitionId" type="text">**Requisition ID**<br />
            RequisitionId of the job</ResponseField>
            <ResponseField name="componentCompany" type="single_select">**Component Company**<br />
            Component company of the job<br />
            Unified field: `legal_entity_id`<br />
            References `/v1/hris/legal-entities?remote_model=legal_entity`</ResponseField>
            <ResponseField name="workLocation" type="single_select">**Work Location**<br />
            Work location of the job<br />
            Unified field: `location_id`</ResponseField>
            <ResponseField name="supervisor" type="single_select">**Supervisor**<br />
            Supervisor of the job<br />
            References `/v1/hris/employees?remote_model=employee`</ResponseField>
            <ResponseField name="employeeType" type="single_select">**Employee Type**<br />
            Employee type for the job</ResponseField>
            <ResponseField name="selectedFLSAStatus" type="single_select">**Selected FLSA Status**<br />
            Selected FLSA status for the job.</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="organizationLevels" type="object">
          **Organization Levels**<br />
          Organization levels for the new hire

          <Expandable title="properties">
            <ResponseField name="orgLevel1Code" type="single_select">**Organization Level 1**<br />
            Organization level 1 code</ResponseField>
            <ResponseField name="orgLevel2Code" type="single_select">**Organization Level 2**<br />
            Organization level 2 code</ResponseField>
            <ResponseField name="orgLevel3Code" type="single_select">**Organization Level 3**<br />
            Organization level 3 code</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="compensation" type="object">
          **Compensation**<br />
          Compensation information for the new hire

          <Expandable title="properties">
            <ResponseField name="isFullTime" type="checkbox">**Is Full Time**<br />
            Whether the new hire is full time</ResponseField>
            <ResponseField name="isSalaried" type="checkbox">**Is Salaried**<br />
            Whether the new hire is salaried</ResponseField>
            <ResponseField name="workHours" type="number">**Work Hours**<br />
            Work hours of the new hire</ResponseField>
            <ResponseField name="weeklyHours" type="number">**Weekly Hours**<br />
            Weekly hours of the new hire. Only applicable for hires not in US/Canadian companies</ResponseField>
            <ResponseField name="currencyCode" type="text">**Currency Code**<br />
            ISO currency code of the new hire</ResponseField>
            <ResponseField name="payRate" type="number">**Pay Rate**<br />
            Pay rate of the new hire</ResponseField>
            <ResponseField name="ratePer" type="single_select">**Rate Per**<br />
            Pay period of the new hire.</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="onboardingOwnerId" type="text">**Onboarding Owner ID**<br />
        External user identifier of the onboarding owner</ResponseField>
        <ResponseField name="referenceId" type="text">**Reference ID**<br />
        Customer-provided identifier to track the new hire against their own system</ResponseField>
        <ResponseField name="hireDate" type="date">**Hire Date**<br />
        Hire date of the new hire</ResponseField>
        <ResponseField name="orientationDate" type="date">**Orientation Date**<br />
        Orientation date of the new hire</ResponseField>
        <ResponseField name="startDate" type="date">**Start Date**<br />
        Start date of the new hire<br />
        Unified field: `start_date`</ResponseField>
        <ResponseField name="pastStartDateReason" type="text">**Past Start Date Reason**<br />
        Reason why the new hire start date is 4 or more business days in the past</ResponseField>

        <ResponseField name="mentor" type="object">
          **Mentor**<br />
          Mentor for the new hire

          <Expandable title="properties">
            <ResponseField name="code" type="single_select">**Mentor**<br />
            Person from UKG Pro<br />
            References `/v1/hris/employees?remote_model=employee`</ResponseField>
            <ResponseField name="description" type="text">**Mentor Description**<br />
            Brief description of mentor</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="personalMessage" type="text">**Personal Message**<br />
        Personal message for the new hire</ResponseField>
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** UKG Pro

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

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

  <Card title="UKG Pro Assessment" icon="https://storage.googleapis.com/kombo-assets/integrations/ukgpro/icon.svg" href="/assessment/connectors/ukgpro">
    UKG Pro for the Assessment category
  </Card>
</CardGroup>
