Nexra
All connectors
Implemented
HR, recruitment & payroll
Gusto logo

Gusto

Read Gusto employees, jobs, compensations, departments, locations, contractors, time off, payrolls and pay schedules; update employee basics and departments.

Use Gusto as the system of record for people and payroll results in HR, finance and scheduling flows, without running payroll from Nexra.

Build a flow with GustoProvider API documentation

Source actions

17

Destination actions

3

Data types

13

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

companies
  • Get company
    Source

    The connected company with status and locations.

    companies.get
compensations
  • List compensations
    Source

    Compensation history of a job (read only).

    compensations.list
contractors
  • Get contractor
    Source

    One contractor by ID.

    contractors.get
  • List contractors
    Source

    Individual and business contractors with wage type.

    contractors.list
custom fields
  • List employee custom fields
    Source

    Typed custom field values of one employee.

    custom_fields.list
departments
  • Create department
    Destination
    Not retried automatically
    Approval before production

    Creates a department (titles must be unique).

    departments.create
  • List departments
    Source

    Company departments with assigned employees and contractors.

    departments.list
  • Rename department
    Destination
    Provider duplicate protection
    Approval before production

    Renames a department (optimistic locking by version).

    departments.update
employees
  • Get employee
    Source

    One employee with the version needed for updates.

    employees.get
  • List employees
    Source

    Employees with jobs, department, status and custom fields.

    employees.list
  • Update employee
    Destination
    Provider duplicate protection
    Approval before production

    Updates an employee's name, emails or phone (optimistic locking by version).

    employees.update
jobs
  • Get job
    Source

    One job by ID.

    jobs.get
  • List employee jobs
    Source

    Jobs of one employee with title, location and current rate.

    jobs.list
locations
  • List locations
    Source

    Company work and filing locations.

    locations.list
pay schedules
  • List pay schedules
    Source

    Pay frequencies and anchor dates.

    pay_schedules.list
payrolls
  • Get payroll
    Source

    One payroll with totals (read only).

    payrolls.get
  • List payrolls
    Source

    Processed or upcoming payrolls with totals (read only).

    payrolls.list
time off activities
  • List time-off activities
    Source

    Accruals, usage and balance changes for one employee.

    time_off_activities.list
time off policies
  • List time-off policies
    Source

    Vacation, sick and other policies with accrual rules.

    time_off_policies.list
time off requests
  • List time-off requests
    Source

    Employee time-off requests with status and hours per day.

    time_off_requests.list

Authentication

Gusto OAuth application with a refresh token (rotated on every refresh)

Plans and access

Gusto companies that authorise a Gusto developer application. Requires an OAuth application from the Gusto Developer Portal; each token is bound to one company. Scopes: companies:read, employees:read, employees:write, jobs:read, compensations:read, departments:read, departments:write, contractors:read, time_off_policies:read, time_off_requests:read, employee_time_off_activities:read, payrolls:read, pay_schedules:read.

Test environment

Developer accounts include demo companies on api.gusto-demo.com.

Rate limits

200 requests per rolling 60 seconds per application and user; HTTP 429 with Retry-After.

Pagination

page and per (max 100) with X-Total-Pages response headers.

Provider events

Gusto webhooks for employee, payroll, company and contractor events. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

  • Requests pin X-Gusto-API-Version 2026-06-15.
  • The token refresh is sent form-encoded; Gusto documents a JSON body, so form encoding is not verified against a live account.
  • Gusto has no updated-since filter for employees; flows read the full list.
  • Payrolls, compensations, time off and pay schedules are read only. Nexra never creates, calculates or submits payroll, and does not write compensation.
  • Employee updates cover name, email, work email and phone; SSN and date of birth are never sent or mapped.
  • Time-off activities support only the vacation and sick types, as documented.
  • Deletes are not implemented. Department creation has no idempotency key; Gusto rejects duplicate department names.

Developer reference

  1. Create the Gusto, Inc. credentials described above with the narrowest permissions your flows need.
  2. In Nexra, open Connect, then Connections, then New connection, choose Gusto, enter its settings and credentials, and tick only the write actions you need. Connection guide
  3. Test the connection, then use its actions as flow sources and destinations. Flow guide
Gusto, Inc. docsAPI referenceGusto, Inc. docsAuthenticationGusto, Inc. docsRate limits

Machine-readable detail: GET /api/public/connect/connectors/gusto and the Connections API.