> ## 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**, a product available only in North America. Please do not confuse it with **ADP Workforce**.

## Supported Features & Coverage

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

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

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

    <Accordion title="Absences">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | start\_date         |       |
      | end\_date           |       |
      | remote\_data        |       |
    </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                |       |
      | 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="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 |
    | ---------------- | ----- |
    | Connection Guide |       |
    | Prerequisites    |       |
    | API Passthrough  |       |
    | Scope Testing    |       |
    | Per Model Tests  |       |
    | Group Types      |       |
    | DEPARTMENT       |       |
    | COST\_CENTER     |       |
  </Tab>

  <Tab title="Create Employee with Form">
    <Note>
      Creating an employee in ADP Workforce Now creates an 'in-progress' hire. The onboarding process must be completed within ADP Workforce Now New Hire wizard before the full employee data will be retrievable via Kombo's `get-employees` API.
    </Note>

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

      <Expandable title="properties">
        <ResponseField name="onboardingTemplateCode" type="single_select" required>**Onboarding Template Code**<br />
        The onboarding template used to complete the hiring process in the ADP Workforce Now New Hire wizard.</ResponseField>

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

          <Expandable title="properties">
            <ResponseField name="birthName" type="object" required>
              **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>

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

          <Expandable title="properties">
            <ResponseField name="hireDate" type="date" required>**Hire Date**<br />
            Unified field: `start_date`</ResponseField>
            <ResponseField name="job" type="single_select" required>**Job Title**</ResponseField>
          </Expandable>
        </ResponseField>

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

          <Expandable title="properties">
            <ResponseField name="payrollGroupCode" type="single_select" required>**Company Code**</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>