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

> Run compliant stablecoin payroll alongside Deel Global Payroll with the Toku deduction

Toku integrates with **Deel** through the Deel API, using scoped organization access that you authorize and control. Deel remains your payroll system of record — Toku handles the digital-asset side.

## How It Works

<CardGroup cols={2}>
  <Card title="1. Connect" icon="plug">
    Authorize Toku's Deel connection for your organization with scoped API access.
  </Card>

  <Card title="2. Sync" icon="rotate">
    Toku syncs your people roster, contracts, and payroll calendar from Deel automatically.
  </Card>

  <Card title="3. Elect" icon="hand-pointer">
    Workers choose what portion of their pay they'd like to receive in stablecoins.
  </Card>

  <Card title="4. Deduct & Deliver" icon="money-bill-transfer">
    Each pay cycle, a single Toku deduction is applied as an adjustment in Deel and Toku delivers the corresponding stablecoin payment on-chain.
  </Card>
</CardGroup>

## The Toku Deduction

Stablecoin payments appear in Deel as one dedicated deduction line item on the worker's pay. Toku calculates the amount for each worker every pay cycle based on their election and applies it through Deel's adjustments API — no manual data entry, and no changes to your gross pay, taxes, or existing pay items.

The deduction is configured once during implementation. Toku's team provides the exact Deel configuration as part of onboarding.

## What You'll Need

* Admin access to your Deel organization
* Admin access to your Toku account
* A short implementation session with the Toku team

## Setup Overview

<Steps>
  <Step title="Authorize the connection">
    Your Deel administrator authorizes Toku's connection with read scopes for people, contracts, and payroll data, plus the single write scope Toku uses for adjustments.
  </Step>

  <Step title="Confirm the Toku deduction">
    Toku sets up the dedicated deduction category for participating workers as part of onboarding.
  </Step>

  <Step title="Connect from Toku">
    In the Toku dashboard, go to **Settings → Payroll Integrations → Add New Integration → Deel** and complete the connection.
  </Step>

  <Step title="Verify the sync">
    Toku validates the connection, previews your worker roster, and begins syncing pay cycles.
  </Step>
</Steps>

<Note>
  Detailed configuration guides are provided to customers during implementation. [Contact the Toku team](https://www.toku.com/contact) to get started.
</Note>

## Each Pay Cycle

Once connected, the integration runs on autopilot:

1. Toku syncs upcoming pay cycles and worker changes from Deel.
2. Toku calculates each worker's stablecoin amount and applies the Toku deduction.
3. You run payroll in Deel exactly as you do today.
4. Toku delivers the stablecoin payments on-chain and provides full reporting and reconciliation.

## Data & Security

* **People, contract, and payroll data** syncs from Deel to Toku on a read-only basis.
* **Deduction adjustments** are the only information Toku writes back to Deel.
* Access uses scoped API tokens that you can revoke at any time, and all credentials are encrypted at rest.

## API Reference

How the integration works at the API level, with calls you can validate against Deel's own documentation:

<CardGroup cols={2}>
  <Card title="Authentication" icon="lock" href="/integrations/deel/authentication">
    How Toku authenticates with Deel
  </Card>

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

  <Card title="Payroll Sync" icon="calendar" href="/integrations/deel/payroll-sync">
    How Toku tracks pay periods and payroll status
  </Card>

  <Card title="The Toku Deduction" icon="money-bill-transfer" href="/integrations/deel/deduction">
    How the deduction is applied each pay period
  </Card>
</CardGroup>

## Related Integrations

<CardGroup cols={2}>
  <Card title="Rippling" icon="building" href="/integrations/rippling">
    Rippling payroll integration
  </Card>

  <Card title="Papaya Global" icon="building" href="/integrations/papaya-global">
    Papaya Global payroll integration
  </Card>
</CardGroup>
