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

# Papaya Global Worker Sync

> How Toku syncs your worker roster from Papaya Global

Toku keeps its roster in sync with Papaya Global so stablecoin elections always map to the right person — whether they're an employee, an EOR worker, or a contractor. Sync is read-only and runs on a schedule agreed during implementation.

## Data Feed

Papaya provisions the worker data feed for the Toku connection through its **Integration Center** — the in-platform hub Papaya uses to exchange HR and payroll data via pre-built APIs, file-based exchange, and custom API development. There is no public REST endpoint to call; the feed is configured per customer during onboarding.

A trimmed example of the worker record in the Toku ↔ Papaya data contract:

```json theme={null}
{
  "worker_id": "PPY-104233",
  "full_name": "Ada Lovelace",
  "work_email": "ada@yourcompany.com",
  "country": "PT",
  "currency": "EUR",
  "pay_group": "PT-Monthly",
  "compensation": {
    "amount": "78000.00",
    "frequency": "annual"
  },
  "status": "active"
}
```

Papaya's public developer documentation lives at [docs.papayaglobal.com](https://docs.papayaglobal.com); the exact feed configuration for your account is confirmed with Papaya's integration support during implementation.

## What Toku Reads

| Field                     | Purpose                                                       |
| ------------------------- | ------------------------------------------------------------- |
| `worker_id`               | Stable identifier used to match the worker across systems     |
| `full_name`, `work_email` | Roster display and worker-portal invitations                  |
| `country`, `currency`     | Maps the worker to the right payroll country and pay currency |
| `pay_group`               | Ties the worker to the correct payroll calendar               |
| `compensation`            | Validates election limits against pay                         |
| `status`                  | Marks departed workers inactive in Toku                       |

## Sync Behavior

* **New workers** appear in Toku automatically once they're active in Papaya.
* **Updates** (name, email, compensation, pay group) flow through on the next scheduled sync.
* **Inactive or offboarded workers** are marked inactive and stop receiving stablecoin payments.
* A manual sync can be triggered anytime from **Settings → Payroll Integrations** in Toku.

<Note>
  Worker sync never writes to Papaya. Toku does not modify worker records, compensation, or employment state — across all 160+ countries Papaya supports.
</Note>

## Next

<CardGroup cols={2}>
  <Card title="Payroll Sync" icon="calendar" href="/integrations/papaya-global/payroll-sync">
    How Toku tracks payroll cycles and G2N data
  </Card>

  <Card title="The Toku Deduction" icon="money-bill-transfer" href="/integrations/papaya-global/deduction">
    How the deduction is delivered as payroll input
  </Card>
</CardGroup>