> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ADP Workforce Now

> Connect ADP Workforce Now to Ravenna to sync employees, teams, and departments, so the AI agent knows who is asking and tickets route by department, role, or manager.

ADP Workforce Now is an HR and payroll suite for mid-sized companies. Ravenna connects to it through its HRIS integration, which uses [Merge.dev](https://merge.dev) for unified HR data access, so there is nothing to build and nothing to maintain on your side.

Synced employee data gives the AI agent context about who is asking, and lets you route tickets by department, role, or manager.

## What syncs

<CardGroup cols={2}>
  <Card title="Employees" icon="users">
    Name, email, avatar, job title, employment type, department, manager, hire date, employment
    status, and employee number
  </Card>

  <Card title="Groups" icon="building">
    Teams and departments, so you can route and scope access by group
  </Card>
</CardGroup>

Data syncs every 24 hours. Only active employees sync, and anyone without a valid work email in ADP Workforce Now is skipped.

<Note>
  ADP Workforce Now is a read-only employee and group source. Time-off workflow actions, such as checking a
  balance or filing a request from a ticket, are provider specific and available today for
  [BambooHR](/integrations/bamboohr/workflows), [HiBob](/integrations/hibob/workflows), and
  [Workday](/integrations/workday/workflows).
</Note>

## Connect ADP Workforce Now

Select **ADP Workforce Now** in the Merge Link provider list, then follow its prompts. Most providers ask for
admin credentials, and some also ask for a subdomain or an API key.

## Prerequisites

<Info>
  Merge supports more HR systems than Ravenna enables by default. If yours is missing from the Merge
  Link provider list, ask support and it can usually be turned on.
</Info>

Before you start, make sure you have:

* An active account with your HR system
* Admin access to it, or someone who has it available to authorize the connection
* Permission to authorize third-party integrations there

## Connect

<Steps>
  <Step title="Open the HRIS integration">
    1. Go to **Settings > Integrations**
    2. Select **HRIS**. One connector covers every supported HR system, so there is no separate card per provider.
  </Step>

  <Step title="Start the connection">
    Select **Connect** to open Merge Link, the guided authorization dialog.
  </Step>

  <Step title="Authorize the connection">
    1. Select your provider from the list
    2. Follow the prompts. Most providers ask for admin credentials, and some also ask for a subdomain or a tenant URL.
    3. Review the requested data permissions and accept them
    4. Select **Finish**
  </Step>

  <Step title="Choose what syncs">
    Set your sync preferences after the connection completes:

    * **Employee status filter**: which employment statuses to sync. Defaults to Active only.
    * **Group type filter**: which group types to sync. Defaults to Teams and Departments.
  </Step>

  <Step title="Wait for the first sync">
    The first sync starts as soon as the connection completes, and employee and group data appears in Ravenna once it finishes.

    <Info>
      Data syncs every 24 hours after that. The integration settings show the last sync time.
    </Info>
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Merge Link authorization fails">
    **Cause**: incorrect credentials, or insufficient permissions in your HR system.

    **Fix**:

    * Check that anything you typed, such as a subdomain or tenant URL, matches your HR system exactly
    * Confirm the account you authorized with has admin access
    * Check that third-party integrations are not blocked in your HR system's settings
    * Try again in a different browser, since extensions can interfere with the dialog
  </Accordion>

  <Accordion title="Employees are missing">
    **Cause**: the sync has not finished, the status filter excludes them, or they have no work email.

    **Fix**:

    * Check the last sync time in the integration settings
    * Confirm your employee status filter includes the statuses you expect, such as Active
    * Confirm each missing person has a valid work email in your HR system. Anyone without one is skipped.
    * Wait for the next 24 hour sync, or disconnect and reconnect to force a fresh one
  </Accordion>

  <Accordion title="Groups or departments are missing">
    **Cause**: the group type filter is excluding them, or they were created after the last sync.

    **Fix**:

    * Confirm your group type filter includes Teams and Departments
    * Confirm the groups exist in your HR system
    * Wait for the next sync to pick up new groups
  </Accordion>
</AccordionGroup>

<Callout icon="link" color="#6B7280">
  Learn more about [every system Ravenna integrates with](/integrations/overview)
</Callout>


## Related topics

- [UKG Pro Workforce Management](/integrations/ukg-pro-wfm/overview.md)
- [Proliant](/integrations/proliant/overview.md)
- [Product Updates](/changelog/2026.md)
- [Setup](/integrations/pagerduty/setup.md)