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

# Applying the Toku Deduction in Deel

> How Toku applies the stablecoin deduction through Deel's Adjustments API

Each payroll cycle, Toku applies one dedicated deduction per participating worker, using Deel's Adjustments API. This is the only write Toku performs against your Deel organization.

## Endpoint

```bash theme={null}
curl -X POST "https://api.letsdeel.com/rest/v2/adjustments" \
  -H "Authorization: Bearer <access_token>" \
  -H "x-client-id: <toku_client_id>" \
  -H "Content-Type: application/json" \
  -d '{
    "contract_id": "37nex2x",
    "amount": "-250.00",
    "description": "Toku Deduction",
    "adjustment_category_id": "<deduction_category_id>",
    "date_of_adjustment": "2026-07-15"
  }'
```

Deel's Adjustments API covers both Global Payroll and EOR, with categories for bonuses, allowances, and deductions — deductions are expressed as negative amounts. Toku targets the dedicated deduction category configured during onboarding, discovered via `GET /rest/v2/adjustments/categories`. See Deel's [Adjustments API announcement](https://www.deel.com/blog/new-adjustments-api/) and the Adjustments reference on the [Deel Developer Platform](https://developer.deel.com/) for the full request schema.

## How the Amount Is Set

* The worker's stablecoin election in Toku determines the amount for each payroll cycle.
* Toku recalculates and updates the adjustment before each cycle, so one-off changes (bonuses, prorated periods, paused elections) are handled automatically.
* The line item appears on the worker's payslip with the Toku description, so payslips stay self-explanatory.

## Guarantees

| Behavior         | Detail                                                               |
| ---------------- | -------------------------------------------------------------------- |
| One line item    | Exactly one Toku deduction per participating worker per cycle        |
| No gross changes | Gross pay, taxes, and every other pay item are untouched             |
| Bounded amount   | The deduction is validated against net pay before it is applied      |
| Reversible       | Removing a worker's election stops the deduction from the next cycle |

<Warning>
  Toku never modifies compensation, tax withholding, benefits, or existing adjustments in Deel — the `adjustments:write` scope is used only for the Toku deduction itself.
</Warning>

## Reconciliation

After the payroll cycle is finalized, Toku reads each applied adjustment back (`GET /rest/v2/adjustments/{id}` and `GET /rest/v2/contracts/{contract_id}/adjustments`), confirms it against the finalized run, and releases the matching on-chain stablecoin payments. Any mismatch blocks settlement and is surfaced in the Toku dashboard before funds move.

## Next

<CardGroup cols={2}>
  <Card title="Integration Overview" icon="map" href="/integrations/deel">
    Back to the Deel integration overview
  </Card>

  <Card title="People Sync" icon="users" href="/integrations/deel/employee-sync">
    How Toku reads your worker roster
  </Card>
</CardGroup>
