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

# ADP Workforce Now HRIS Integration

> ADP Workforce Now connector for Kombo's HRIS API

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

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

## Guides and Resources

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

## General Notes

* This connector is built for [**ADP Workforce Now**](https://developers.adp.com/apis/api-explorer/hcm-offrg-wfn), a product available only in North America. Please do not confuse it with [**ADP Workforce**](https://developers.adp.com/apis/api-explorer/hcm-offrg-wkfc).

## Supported Features & Coverage

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

    <Accordion title="Work Locations">
      | Field | Notes |
      | - | - |
      | id | |
      | remote\_id | |
      | changed\_at | |
      | remote\_deleted\_at | |
      | address | |
    </Accordion>

    <Accordion title="Employees">
      <Note>
        Only the primary employment's work location is exposed via Kombo's API. Only the primary employment's manager is exposed via Kombo's API. Only the first nationality is exposed via Kombo's API.
      </Note>

      | Field | Notes |
      | - | - |
      | id | |
      | remote\_id | |
      | changed\_at | |
      | remote\_deleted\_at | |
      | employee\_number | |
      | first\_name | |
      | last\_name | |
      | nationality | |
      | display\_full\_name | |
      | 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 | |
      | custom\_fields | |
      | integration\_fields | |
    </Accordion>

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

    <Accordion title="Absences">
      | Field | Notes |
      | - | - |
      | id | |
      | remote\_id | |
      | changed\_at | |
      | remote\_deleted\_at | |
      | employee\_id | |
      | start\_date | |
      | end\_date | |
    </Accordion>

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

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

    <Accordion title="Staffing entities">
      <Note>
        Onboarding templates the connected ADP Workforce Now user cannot hire into are synced with status `CLOSED`. Filter staffing entities by `OPEN_UNLIMITED` when picking a template for create employee.
      </Note>

      | Field | Notes |
      | - | - |
      | id | |
      | remote\_id | |
      | changed\_at | |
      | remote\_deleted\_at | |
      | name | |
      | model\_type | |
      | status | |
      | employment\_types | |
      | parent\_id | |
      | custom\_fields | |
    </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">
      <Note>
        Creating an employee in ADP Workforce Now creates an 'in-progress' hire. The onboarding process must be completed within ADP Workforce Now's UI before the full employee data will be retrievable via Kombo's API. ADP Workforce Now requires two separate remote fields for creating an employee: `onboarding_template_code` and `applicant_payroll_profile_group_code`. View the possible values in the Kombo dashboard by clicking on the ADP Workforce Now integration and viewing the field report in the settings tab.
      </Note>

      | Input Field | Notes |
      | - | - |
      | first\_name | |
      | last\_name | |
      | work\_email | |
      | job\_title | |
      | home\_address.street\_1 | |
      | home\_address.city | |
      | home\_address.zip\_code | |
      | home\_address.country | |
      | mobile\_phone\_number | |
      | start\_date | |
    </Accordion>

    <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 |
    | - | - |
    | API Passthrough | |
    | Scope Testing | |
    | Per Model Tests | |
    | Custom Field Explorer | |
    | Employees | |
    | Connection Guide | |
    | Prerequisites | |
    | Group Types | |
    | DEPARTMENT | |
    | COST\_CENTER | |
  </Tab>

  <Tab title="Create Employee with Form">
    <Note>
      Creates an in-progress hire. Complete onboarding in ADP Workforce Now before the full employee data is available through Kombo.
    </Note>

    <Note>
      Pass the staffing\_entity\_id of an available ADP onboarding template. Templates unavailable to the connected user have status CLOSED and cannot be used.
    </Note>

    <ResponseField name="applicantOnboarding" type="object" required>
      **Applicant Onboarding**

      <Expandable title="properties">
        <ResponseField name="onboardingTemplateCode" type="single_select" required>**Onboarding Template Code**</ResponseField>

        <ResponseField name="applicantWorkerProfile" type="object" required>
          **Applicant Worker Profile**

          <Expandable title="properties">
            <ResponseField name="hireDate" type="date" required>**Hire Date**<br />
            Start date of the employee. Also considered to be the hire date<br />
            Unified field: `start_date`</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="applicantPayrollProfile" type="object" required>
          **Applicant Payroll Profile**

          <Expandable title="properties">
            <ResponseField name="payrollGroupCode" type="single_select" required>**Company Code**</ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="applicantPersonalProfile" type="object" required>
          **Applicant Personal Profile**

          <Expandable title="properties">
            <ResponseField name="birthName" type="object" required>
              **Birth Name**

              <Expandable title="properties">
                <ResponseField name="givenName" type="text" required>**First Name**<br />
                The first name of the employee<br />
                Unified field: `first_name`</ResponseField>
                <ResponseField name="familyName" type="text" required>**Last Name**<br />
                The last name of the employee<br />
                Unified field: `last_name`</ResponseField>
              </Expandable>
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** ADP Workforce Now

For **ADP Workforce Now**, we also offer the following other connector variants:

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.