Paychex Worker Sync

Toku keeps its roster in sync with Paychex Flex so stablecoin elections always map to the right person. Paychex models both W-2 employees and 1099 contractors as workers, and Toku syncs both. Sync is read-only and runs automatically after every connection and on a rolling schedule.

Endpoint

Toku reads workers through Paychex’s company-scoped workers resource:

curl "https://api.paychex.com/companies/<company_id>/workers" \
  -H "Authorization: Bearer <access_token>"

A trimmed, representative example response:

{
  "content": [
    {
      "workerId": "00Z5V9BJTLXCR27S3RS4",
      "workerType": "EMPLOYEE",
      "name": {
        "givenName": "Ada",
        "familyName": "Lovelace"
      },
      "currentStatus": {
        "statusType": "ACTIVE"
      }
    },
    {
      "workerId": "00Z5V9CQ8MXDN41T7UW2",
      "workerType": "INDEPENDENT_CONTRACTOR",
      "name": {
        "givenName": "Grace",
        "familyName": "Hopper"
      },
      "currentStatus": {
        "statusType": "ACTIVE"
      }
    }
  ]
}

See Paychex’s reference for the full schema: Worker resource.

What Toku Reads

Field	Purpose
`workerId`	Stable identifier used to match the worker across systems
`workerType`	Distinguishes W-2 employees (`EMPLOYEE`) from 1099 contractors (`INDEPENDENT_CONTRACTOR`)
`name`	Roster display and worker-portal invitations
`currentStatus`	Marks departed workers inactive in Toku

Paychex exposes worker sub-resources for compensation, communications, and direct deposit; Toku reads only what it needs to validate elections and display the roster.

Sync Behavior

New workers appear in Toku automatically once they exist in Paychex Flex.
Updates (name, status, worker type) flow through on the next sync.
Inactive workers are marked inactive in Toku and stop receiving stablecoin payments.
A manual sync can be triggered anytime from Settings → Payroll Integrations in Toku.

Worker sync never writes to Paychex. Toku does not modify worker records, compensation, communications, or direct deposit details.

Payroll Sync

How Toku tracks pay periods and checks

The Toku Deduction

How the deduction is applied via pay components

⌘I

​Endpoint

​What Toku Reads

​Sync Behavior

​Next

Payroll Sync

The Toku Deduction

Endpoint

What Toku Reads

Sync Behavior

Next