Deel Payroll Sync - Toku Docs

Toku tracks your Deel Global Payroll calendar so the Toku deduction is always applied to the right payroll cycle — and so on-chain delivery lines up with each cycle’s finalization.

Endpoints

Toku reads payroll data through Deel’s Global Payroll (gp/) resources. Per-worker payslips:

curl "https://api.letsdeel.com/rest/v2/gp/workers/<worker_id>/payslips" \
  -H "Authorization: Bearer <access_token>" \
  -H "x-client-id: <toku_client_id>"

A trimmed example response:

{
  "data": [
    {
      "id": "f2a8c3de-91b4-4f2e-8a77-3d0c1c9e5b21",
      "from": "2026-07-01",
      "to": "2026-07-15",
      "status": "FINALIZED"
    }
  ]
}

For cycle-level verification, Toku reads the gross-to-net report for the payroll run:

curl "https://api.letsdeel.com/rest/v2/gp/reports/<gp_report_id>/gross_to_net" \
  -H "Authorization: Bearer <access_token>" \
  -H "x-client-id: <toku_client_id>"

A CSV export of the same report is available at /gross_to_net/csv. See Deel’s reference for the full schemas: Global Payroll introduction.

What Toku Reads

Data	Purpose
Payslip period (`from` / `to`)	Determines which elections apply to the cycle
Payslip `status`	Confirms the cycle is finalized before Toku settles
Gross-to-net report	Verifies the Toku deduction line against the finalized run

Sync Behavior

Upcoming payroll cycles appear in the Toku dashboard as Toku syncs them from Deel.
Deel’s webhook events — including payroll cycle finalized — notify Toku when a cycle closes, triggering reconciliation.
Once a cycle is finalized, Toku verifies the applied deductions against the gross-to-net report and releases the corresponding stablecoin payments.

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

The Toku Deduction

How the deduction is applied via the Deel API

Authentication

OAuth 2.0 scopes and token handling

⌘I

​Endpoints

​What Toku Reads

​Sync Behavior

​Next

The Toku Deduction

Authentication

Endpoints

What Toku Reads

Sync Behavior

Next