Applying the Toku Deduction in Gusto

Each pay period, Toku applies one dedicated deduction per participating employee, using Gusto’s employee deduction (garnishments) API. This is the only write Toku performs against your Gusto account.

Endpoint

curl -X POST "https://api.gusto.com/v1/employees/<employee_id>/garnishments" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "250.00",
    "description": "Toku Deduction",
    "recurring": false,
    "court_ordered": false,
    "deduct_as_percentage": false,
    "active": true
  }'

Gusto models employee deductions and garnishments on the same resource — Toku uses it as a standard, non-court-ordered employee deduction. See Gusto’s reference to validate the call: Create a garnishment (employee deduction).

How the Amount Is Set

The employee’s stablecoin election in Toku determines the amount for each pay period.
Toku recalculates and updates the deduction before each run, so one-off changes (bonuses, prorated periods, paused elections) are handled automatically.
The line item appears on the employee’s pay statement with the Toku description, so payslips stay self-explanatory.

Guarantees

Behavior	Detail
One line item	Exactly one Toku deduction per participating employee per run
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 an employee’s election stops the deduction from the next run

Toku never modifies compensation, tax withholding, benefits, or existing deductions in Gusto — the scope of write access is limited to the Toku deduction itself.

Reconciliation

After the payroll is processed, Toku reads the finalized run, confirms each applied deduction, and releases the matching on-chain stablecoin payments. Any mismatch blocks settlement and is surfaced in the Toku dashboard before funds move.

Integration Overview

Back to the Gusto integration overview

Employee Sync

How Toku reads your employee roster

⌘I

​Endpoint

​How the Amount Is Set

​Guarantees

​Reconciliation

​Next

Integration Overview

Employee Sync

Endpoint

How the Amount Is Set

Guarantees

Reconciliation

Next