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

# Rippling Integration

> Run compliant stablecoin payroll alongside Rippling with the Toku deduction

Toku integrates with **Rippling** through the Rippling API, using an OAuth connection with scopes your admin approves at install time. Rippling 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 Rippling connection for your company with a standard OAuth install — no credentials to copy around.
  </Card>

  <Card title="2. Sync" icon="rotate">
    Toku syncs your worker roster and payroll runs from Rippling automatically.
  </Card>

  <Card title="3. Elect" icon="hand-pointer">
    Employees 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 period, a single Toku deduction is reflected as a pay input on the payroll run and Toku delivers the corresponding stablecoin payment on-chain.
  </Card>
</CardGroup>

## The Toku Deduction

Stablecoin payments appear in Rippling as one dedicated line item on the worker's pay. Toku calculates the amount for each worker every pay period based on their election and applies it as a pay input through Rippling's payroll APIs — 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 Rippling configuration as part of onboarding.

## What You'll Need

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

## Setup Overview

<Steps>
  <Step title="Authorize the connection">
    Your Rippling administrator installs and approves Toku's connection, reviewing the read scopes for workers and payroll plus the single write scope Toku uses for pay inputs.
  </Step>

  <Step title="Confirm the Toku deduction">
    Toku sets up the dedicated pay line item 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 → Rippling** and complete the connection.
  </Step>

  <Step title="Verify the sync">
    Toku validates the connection, previews your worker roster, and begins syncing payroll runs.
  </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 Period

Once connected, the integration runs on autopilot:

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

## Data & Security

* **Worker and payroll data** syncs from Rippling to Toku on a read-only basis.
* **The Toku pay input** is the only information Toku writes back to Rippling.
* Access uses OAuth with admin-approved, per-company scopes — you can revoke it at any time from Rippling, and all tokens are encrypted at rest.

## API Reference

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

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

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

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

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

## Related Integrations

<CardGroup cols={2}>
  <Card title="Deel" icon="building" href="/integrations/deel">
    Deel Global Payroll integration
  </Card>

  <Card title="Gusto" icon="building" href="/integrations/gusto">
    Gusto payroll integration
  </Card>
</CardGroup>
