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

# UKG Pro Payroll Sync

> How Toku tracks pay groups and upcoming payrolls in UKG Pro

Toku tracks your UKG Pro payroll calendar so the Toku deduction is always posted to the right pay run — and so on-chain delivery lines up with your pay date.

## How It Syncs

Toku pulls upcoming payrolls and pay groups from UKG Pro on a rolling cadence (roughly every 15 minutes) through UKG Pro's Payroll Integration web services, using the same service account as the rest of the integration. Each employee's `payGroupCode` (from [employee sync](/integrations/ukg/employee-sync)) determines which pay run their deduction belongs to.

For reconciliation, Toku also reads posted deductions through the payroll deductions history resource:

```bash theme={null}
curl "https://<hostname>.ultipro.com/payroll/v1/payroll-deductions-history?page=1&per_Page=100" \
  -H "Authorization: Basic <base64(username:password)>" \
  -H "US-Customer-Api-Key: <customer_api_key>"
```

A trimmed example response:

```json theme={null}
[
  {
    "employeeId": "AB1CD2000EFG",
    "payGroup": "BIWEEKLY",
    "periodControlDate": "2026-07-15",
    "deductionBenefitPlan": "TOKU",
    "employeeDeductionAmount": 250.00
  }
]
```

See UKG's reference for the full schema: [Payroll deductions history](https://developer.ukg.com/hcm/reference/payrolldeductionshistory_get). Reading it requires the **View** role on *Payroll Integration*.

## What Toku Reads

| Field                          | Purpose                                                     |
| ------------------------------ | ----------------------------------------------------------- |
| Pay group and pay period dates | Ties each Toku pay cycle to the exact UKG Pro pay run       |
| Period control / pay date      | Schedules on-chain stablecoin delivery                      |
| `deductionBenefitPlan`         | Filters history to the dedicated Toku deduction code        |
| `employeeDeductionAmount`      | Confirms the applied amount matches the employee's election |

## Sync Behavior

* Upcoming pay runs appear in the Toku dashboard shortly after they exist in UKG Pro.
* When a pay run is processed, Toku reconciles the applied deductions against the deductions history and releases the corresponding stablecoin payments.
* Off-cycle runs are detected and skipped by default (configurable during onboarding).

<Note>
  Payroll sync is read-only. Toku never creates, calculates, or submits payrolls in UKG Pro — your team keeps full control of running payroll.
</Note>

## Next

<CardGroup cols={2}>
  <Card title="The Toku Deduction" icon="money-bill-transfer" href="/integrations/ukg/deduction">
    How the deduction is posted each pay period
  </Card>

  <Card title="Authentication" icon="lock" href="/integrations/ukg/authentication">
    Service accounts, API keys, and permissions
  </Card>
</CardGroup>