> ## 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.

# Deel Payroll Sync

> How Toku tracks payroll cycles and payslips in Deel

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:

```bash theme={null}
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:

```json theme={null}
{
  "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:

```bash theme={null}
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](https://developer.deel.com/api/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.

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

## Next

<CardGroup cols={2}>
  <Card title="The Toku Deduction" icon="money-bill-transfer" href="/integrations/deel/deduction">
    How the deduction is applied via the Deel API
  </Card>

  <Card title="Authentication" icon="lock" href="/integrations/deel/authentication">
    OAuth 2.0 scopes and token handling
  </Card>
</CardGroup>