UKG Pro Payroll Sync

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) determines which pay run their deduction belongs to. For reconciliation, Toku also reads posted deductions through the payroll deductions history resource:

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:

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

See UKG’s reference for the full schema: Payroll deductions history. 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).

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

The Toku Deduction

How the deduction is posted each pay period

Authentication

Service accounts, API keys, and permissions

⌘I

​How It Syncs

​What Toku Reads

​Sync Behavior

​Next

The Toku Deduction

Authentication

How It Syncs

What Toku Reads

Sync Behavior

Next