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

# Gusto Employee Sync

> How Toku syncs your employee roster from Gusto

Toku keeps its employee roster in sync with Gusto so stablecoin elections always map to the right person. Sync is read-only and runs automatically after every connection and on a rolling schedule.

## Endpoint

Toku reads employees through Gusto's company-scoped employees resource:

```bash theme={null}
curl "https://api.gusto.com/v1/companies/<company_id>/employees" \
  -H "Authorization: Bearer <access_token>"
```

A trimmed example response:

```json theme={null}
[
  {
    "uuid": "9779767c-6044-48e0-bf68-aeb370b9a2e7",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "email": "ada@yourcompany.com",
    "company_uuid": "1b224dcb-4386-4b3e-b81f-9e6c18e0bcd3",
    "terminated": false,
    "onboarded": true,
    "jobs": [
      {
        "title": "Senior Engineer",
        "payment_unit": "Year",
        "rate": "180000.00"
      }
    ]
  }
]
```

See Gusto's reference for the full schema: [Get employees of a company](https://docs.gusto.com/embedded-payroll/reference/get-v1-companies-company_id-employees).

## What Toku Reads

| Field                              | Purpose                                                     |
| ---------------------------------- | ----------------------------------------------------------- |
| `uuid`                             | Stable identifier used to match the employee across systems |
| `first_name`, `last_name`, `email` | Roster display and employee-portal invitations              |
| `terminated`                       | Marks departed employees inactive in Toku                   |
| `jobs[].rate`, `payment_unit`      | Validates election limits against compensation              |

## Sync Behavior

* **New employees** appear in Toku automatically after they finish Gusto onboarding.
* **Updates** (name, email, compensation) flow through on the next sync.
* **Terminated employees** are marked inactive and stop receiving stablecoin payments.
* A manual sync can be triggered anytime from **Settings → Payroll Integrations** in Toku.

<Note>
  Employee sync never writes to Gusto. Toku does not modify employee records, compensation, or onboarding state.
</Note>

## Next

<CardGroup cols={2}>
  <Card title="Payroll Sync" icon="calendar" href="/integrations/gusto/payroll-sync">
    How Toku tracks pay periods and payroll status
  </Card>

  <Card title="The Toku Deduction" icon="money-bill-transfer" href="/integrations/gusto/deduction">
    How the deduction is applied via the Gusto API
  </Card>
</CardGroup>