> ## Documentation Index
> Fetch the complete documentation index at: https://klef.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Gusto

<div className="page-title-row">
  <img src="https://mintcdn.com/klef/xJ0kXbcegZOD2G3h/images/connectors/gusto.svg?fit=max&auto=format&n=xJ0kXbcegZOD2G3h&q=85&s=0e343a998aa50f436eac7d87c1f293a7" alt="" noZoom width="24" height="24" data-path="images/connectors/gusto.svg" />

  <h1>Gusto</h1>
</div>

A run reads the whole roster.

## Connection

Connecting sends you to Gusto to approve Klef's access.

## Fields

The [worker model](/docs/connectors/worker-model) fields Klef fills from Gusto.

| Field                                       | Type   | Description                                                         |
| ------------------------------------------- | ------ | ------------------------------------------------------------------- |
| `worker.source_id`                          | string | The worker's ID in the HR system.                                   |
| `worker.employee_id`                        | string | Employee number from the HR system. Hidden from the mapping editor. |
| `worker.legal_name`                         | object | Legal name.                                                         |
| `worker.legal_name.given`                   | string | Legal first name.                                                   |
| `worker.legal_name.family`                  | string | Legal last name.                                                    |
| `worker.preferred_name`                     | object | Name the worker goes by.                                            |
| `worker.preferred_name.given`               | string | Preferred first name.                                               |
| `worker.preferred_name.family`              | string | Preferred last name.                                                |
| `worker.display_name`                       | string | Full name for display.                                              |
| `worker.business_email`                     | string | Primary business email address.                                     |
| `worker.personal_email`                     | string | Primary personal email address.                                     |
| `worker.status`                             | string | Pending, Active, Leave, Terminated, Deceased or Unspecified.        |
| `worker.start_date`                         | date   | Start date of the primary assignment.                               |
| `worker.end_date`                           | date   | End date of the primary assignment.                                 |
| `worker.hire_date`                          | date   | Original hire date.                                                 |
| `worker.department`                         | object | Department of the primary assignment.                               |
| `worker.department.code`                    | string | Department code.                                                    |
| `worker.department.name`                    | string | Department name.                                                    |
| `worker.job`                                | object | Job of the primary assignment.                                      |
| `worker.job.code`                           | string | Job code.                                                           |
| `worker.job.name`                           | string | Job name.                                                           |
| `worker.manager`                            | string | Source ID of the primary assignment's manager.                      |
| `worker.location`                           | object | Work location of the primary assignment.                            |
| `worker.location.code`                      | string | Location code.                                                      |
| `worker.location.name`                      | string | Location name.                                                      |
| `worker.location.street`                    | string | Street address.                                                     |
| `worker.location.city`                      | string | City.                                                               |
| `worker.location.region`                    | string | State or region.                                                    |
| `worker.location.postal_code`               | string | Postal code.                                                        |
| `worker.location.country`                   | string | Country.                                                            |
| `worker.worker_type`                        | string | Employee or Contractor, from the primary assignment.                |
| `worker.business_phone`                     | string | Business phone number.                                              |
| `worker.custom_fields`                      | map    | Fields your HR system defines, by name.                             |
| `worker.custom_fields.<name>`               | string | Field value.                                                        |
| `worker.assignments`                        | array  | Every job the worker holds.                                         |
| `worker.assignments[].source_id`            | string | The assignment's ID in the HR system.                               |
| `worker.assignments[].is_primary`           | bool   | Whether this is the worker's primary assignment.                    |
| `worker.assignments[].status`               | string | Pending, Active, Leave, Terminated, Deceased or Unspecified.        |
| `worker.assignments[].job`                  | object | Job of the assignment.                                              |
| `worker.assignments[].job.code`             | string | Job code.                                                           |
| `worker.assignments[].job.name`             | string | Job name.                                                           |
| `worker.assignments[].department`           | object | Department of the assignment.                                       |
| `worker.assignments[].department.code`      | string | Department code.                                                    |
| `worker.assignments[].department.name`      | string | Department name.                                                    |
| `worker.assignments[].location`             | object | Work location.                                                      |
| `worker.assignments[].location.code`        | string | Location code.                                                      |
| `worker.assignments[].location.name`        | string | Location name.                                                      |
| `worker.assignments[].location.street`      | string | Street address.                                                     |
| `worker.assignments[].location.city`        | string | City.                                                               |
| `worker.assignments[].location.region`      | string | State or region.                                                    |
| `worker.assignments[].location.postal_code` | string | Postal code.                                                        |
| `worker.assignments[].location.country`     | string | Country.                                                            |
| `worker.assignments[].manager`              | string | Source ID of the assignment's manager.                              |
| `worker.assignments[].start_date`           | date   | Start date.                                                         |
| `worker.assignments[].end_date`             | date   | End date.                                                           |
| `worker.assignments[].worker_type`          | string | Employee or Contractor.                                             |
