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

# Dayforce HRIS Integration

> Dayforce connector for Kombo's HRIS API

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

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

## Guides and Resources

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

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Work Locations">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | address             |       |
      | type                |       |
      | 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   |       |
      | job\_title            |       |
      | work\_email           |       |
      | mobile\_phone\_number |       |
      | ssn                   |       |
      | gender                |       |
      | ethnicity             |       |
      | marital\_status       |       |
      | employment\_status    |       |
      | employment\_type      |       |
      | weekly\_hours         |       |
      | work\_location\_id    |       |
      | manager\_id           |       |
      | home\_address         |       |
      | date\_of\_birth       |       |
      | start\_date           |       |
      | custom\_fields        |       |
      | integration\_fields   |       |
      | remote\_data          |       |
    </Accordion>

    <Accordion title="Employments">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | job\_title          |       |
      | pay\_rate           |       |
      | pay\_period         |       |
      | 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="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       |       |
    | Delta Syncs           |       |
    | Group Types           |       |
    | DEPARTMENT            |       |
    | COST\_CENTER          |       |
    | Custom Field Explorer |       |
    | Employees             |       |
  </Tab>

  <Tab title="Create Employee with Form">
    <Note>
      The custom Employee Properties are followup calls to the Dayforce API and can partially fail. This means you create a new employee, but some custom properties are not created.
    </Note>

    <Info>
      Some **optional** form fields are referencing the following data models:

      * Employees

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

    <Warning>
      This form may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
    </Warning>

    <ResponseField name="FirstName" type="text" required>**First Name**<br />
    The first name of the employee<br />
    Unified field: `first_name`</ResponseField>
    <ResponseField name="LastName" type="text" required>**Last Name**<br />
    The last name of the employee<br />
    Unified field: `last_name`</ResponseField>
    <ResponseField name="BirthDate" type="date" required>**Date of Birth**<br />
    The employee's date of birth<br />
    Unified field: `date_of_birth`</ResponseField>

    <ResponseField name="Culture" type="single_select" required />

    <ResponseField name="HireDate" 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="SocialSecurityNumber" type="text">**Social Security Number**<br />
    The Social Security Number can be required depending on the seeing of Dayforce.</ResponseField>
    <ResponseField name="Gender" type="single_select">The gender of the employee</ResponseField>
    <ResponseField name="SeniorityDate" type="date">**Seniority Date**</ResponseField>
    <ResponseField name="SendFirstTimeAccessEmail" type="checkbox">**Send First Time Access Email**</ResponseField>
    <ResponseField name="RetirementRequestDate" type="date">**Retirement Request Date**</ResponseField>
    <ResponseField name="EmployeeId" type="number">**Employee ID**</ResponseField>
    <ResponseField name="XRefCode" type="text">**Username**<br />
    The username for the employee, which is also the XRefCode.</ResponseField>

    <ResponseField name="Addresses" type="object" required>
      <Expandable title="properties">
        <ResponseField name="Address1" type="text" required>**Street 1**<br />
        The street address of the employee<br />
        Unified field: `home_address.street_1`</ResponseField>
        <ResponseField name="City" type="text" required>The city of the employee<br />
        Unified field: `home_address.city`</ResponseField>
        <ResponseField name="PostalCode" type="text" required>**ZIP Code**<br />
        The ZIP code of the employee<br />
        Unified field: `home_address.zip_code`</ResponseField>
        <ResponseField name="State" type="single_select" required>The XRefCode of the state</ResponseField>
        <ResponseField name="Country" type="single_select" required>The XRefCode of the country</ResponseField>
        <ResponseField name="EffectiveStart" type="date" required>**Effective Start**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="Contacts" type="object" required>
      <Expandable title="properties">
        <ResponseField name="HomePhone" type="object" required>
          **Home Phone**

          <Expandable title="properties">
            <ResponseField name="ContactNumber" type="text" required>**Mobile Phone Number**<br />
            The mobile phone number of the employee<br />
            Unified field: `mobile_phone_number`</ResponseField>
            <ResponseField name="EffectiveStart" type="date" required>**Effective Start**</ResponseField>
            <ResponseField name="EffectiveEnd" type="date">**Effective End**</ResponseField>
            <ResponseField name="Country" type="single_select" required>The XRefCode of the country</ResponseField>
            <ResponseField name="Extension" type="text">The extension of the phone number</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="PersonalEmail" type="object">
          **Personal Email**

          <Expandable title="properties">
            <ResponseField name="ElectronicAddress" type="text" required>**Private Email**<br />
            The private email address of the employee<br />
            Unified field: `private_email`</ResponseField>
            <ResponseField name="EffectiveStart" type="date" required>**Effective Start**</ResponseField>
            <ResponseField name="EffectiveEnd" type="date">**Effective End**</ResponseField>
            <ResponseField name="Country" type="single_select" required>The XRefCode of the country</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="BusinessEmail" type="object">
          **Business Email**

          <Expandable title="properties">
            <ResponseField name="ElectronicAddress" type="text" required>**Work Email**<br />
            The email address of the employee<br />
            Unified field: `work_email`</ResponseField>
            <ResponseField name="EffectiveStart" type="date" required>**Effective Start**</ResponseField>
            <ResponseField name="EffectiveEnd" type="date">**Effective End**</ResponseField>
            <ResponseField name="Country" type="single_select" required>The XRefCode of the country</ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="EmploymentStatuses" type="object" required>
      **Employment Status**

      <Expandable title="properties">
        <ResponseField name="PayType" type="single_select" required>**Pay Type**</ResponseField>
        <ResponseField name="PayClass" type="single_select" required>**Pay Class**</ResponseField>
        <ResponseField name="PayGroup" type="single_select" required>**Pay Group**</ResponseField>
        <ResponseField name="BaseRate" type="number">**Base Rate**</ResponseField>
        <ResponseField name="BaseSalary" type="number" required>**Base Salary**<br />
        Unified field: `yearly_salary`</ResponseField>
        <ResponseField name="MonthlyHours" type="number">**Monthly Hours**</ResponseField>
        <ResponseField name="AverageDailyHours" type="number">**Average Daily Hours**</ResponseField>
        <ResponseField name="TargetBonus" type="number">**Target Bonus**</ResponseField>
        <ResponseField name="FTEAnnualSalary" type="number">**FTE Annual Salary**</ResponseField>
        <ResponseField name="ShiftRotation" type="single_select">**Shift Rotation**</ResponseField>
        <ResponseField name="ShiftRotationDayOffset" type="number">**Shift Rotation Day Offset**</ResponseField>
        <ResponseField name="ShiftRotationStartDate" type="date">**Shift Rotation Start Date**</ResponseField>
        <ResponseField name="CreateShiftRotationShift" type="checkbox">**Create Shift Rotation Shift**</ResponseField>
        <ResponseField name="PayHolidayGroup" type="single_select">**Pay Holiday Group**</ResponseField>
        <ResponseField name="EmployeeGroup" type="single_select">**Employee Group**</ResponseField>
        <ResponseField name="PayPolicy" type="single_select">**Pay Policy**</ResponseField>
        <ResponseField name="EntitlementPolicy" type="single_select">**Entitlement Policy**</ResponseField>
        <ResponseField name="TimeOffPolicy" type="single_select">**Time Off Policy**</ResponseField>
        <ResponseField name="PayrollPolicy" type="single_select">**Payroll Policy**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="Roles" type="object" required>
      <Expandable title="properties">
        <ResponseField name="Role" type="text" required>The XRefCode of the role of the employee</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="UnionMemberships" type="object">
      **Union Memberships**

      <Expandable title="properties">
        <ResponseField name="Union" type="single_select" required>Union</ResponseField>
        <ResponseField name="UnionMembershipDate" type="date" required>**Union Membership Date**</ResponseField>
        <ResponseField name="EffectiveStart" type="date" required>**Effective Start**</ResponseField>
        <ResponseField name="EffectiveEnd" type="date">**Effective End**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="WorkAssignments" type="object" required>
      **Work Assignments**

      <Expandable title="properties">
        <ResponseField name="Position" type="single_select" required />

        <ResponseField name="Location" type="single_select" required />

        <ResponseField name="EffectiveStart" type="date" required>**Effective Start**</ResponseField>
        <ResponseField name="IsVirtual" type="checkbox">**Is Virtual**</ResponseField>
        <ResponseField name="BusinessTitle" type="text">**Business Title**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="WorkContracts" type="object">
      **Work Contracts**

      <Expandable title="properties">
        <ResponseField name="EndDate" type="date">**End Date**</ResponseField>
        <ResponseField name="AverageNumOfDays" type="number">**Average Number of Days**</ResponseField>
        <ResponseField name="BaseHours" type="number">**Base Hours**</ResponseField>
        <ResponseField name="BaseComplementaryHours" type="number">**Base Complementary Hours**</ResponseField>
        <ResponseField name="ContractWorkPercent" type="number">**Contract Work Percent**</ResponseField>
        <ResponseField name="CreateShiftOnHolidays" type="checkbox">**Create Shift on Holidays**</ResponseField>
        <ResponseField name="FullTimeHours" type="number">**Full Time Hours**</ResponseField>
        <ResponseField name="StartDate" type="date">**Start Date**</ResponseField>
        <ResponseField name="WorkPatternLengthDays" type="number">**Work Pattern Length Days**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="OnboardingPolicies" type="object">
      **Onboarding Policies**

      <Expandable title="properties">
        <ResponseField name="OnboardingPolicy" type="text" required>**Onboarding Policy**<br />
        The XRefCode of the onboarding policy</ResponseField>
        <ResponseField name="EffectiveStart" type="date" required>**Effective Start**</ResponseField>
        <ResponseField name="EffectiveEnd" type="date" required>**Effective End**</ResponseField>
        <ResponseField name="IsInternalHire" type="checkbox" required>**Is Internal Hire**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="EmployeeManagers" type="object">
      **Employee Managers**

      <Expandable title="properties">
        <ResponseField name="EffectiveStart" type="date">**Effective Start**</ResponseField>
        <ResponseField name="EffectiveEnd" type="date">**Effective End**</ResponseField>
        <ResponseField name="ManagerXRefCode" type="single_select">**Manager XRefCode**<br />
        References `/v1/hris/employees?remote_model=employee`</ResponseField>
        <ResponseField name="ManagerType" type="text">**Manager Type**<br />
        The type of manager</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="EmployeeProperties" type="object">
      **Custom Employee Properties**

      <Expandable title="properties">
        <Warning>
          This object may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
        </Warning>
      </Expandable>
    </ResponseField>
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** Dayforce

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

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