Gusto
Bring new starters, changes and leavers from Gusto into every system that needs them, with HR approving each change.
35 ways to read, 13 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Gusto, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Add people to departmentApproval by rule
- Create departmentApproval by rule
- List company adminsRead
Example flow
- Gusto · List company adminsDone
- Gusto · Add people to departmentNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Gusto.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Gusto
- Gusto's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect a Gusto, Inc. test account before you go live.
For developers
Technical detail
Read Gusto people, jobs, departments, locations, time sheets, time off, benefits plans and payroll results; maintain departments, locations, work addresses and time sheets.
Gusto, Inc. API docs- Source actions
- 35
- Destination actions
- 13
- Data types
- 24
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Admins1
- List company adminsSource
Payroll admins of the company.
Benefits1
- List benefit typesSource
Benefit types Gusto supports, with tax treatment.
Companies1
- Get companySource
The connected company with status and locations.
Company benefits2
- Get company benefitSource
One company benefit plan (employee enrolments and amounts are not requested).
- List company benefitsSource
Benefit plans the company offers (no employee deductions).
Company custom fields1
- List company custom fieldsSource
Employee custom field definitions with type and options.
Compensations2
- Get compensationSource
One compensation record (read only).
- List compensationsSource
Compensation history of a job (read only).
Contractors3
- Get contractorSource
One contractor by ID.
- List contractorsSource
Individual and business contractors with wage type.
- Update contractorDestinationProvider duplicate protectionApproval before production
Updates a contractor's name, business name or work email (optimistic locking).
Custom fields1
- List employee custom fieldsSource
Typed custom field values of one employee.
Department members1
- Add people to departmentDestinationProvider duplicate protectionApproval before production
Adds employees and contractors to a department (optimistic locking by version).
Departments4
- Create departmentDestinationNot retried automaticallyApproval before production
Creates a department (titles must be unique).
- Get departmentSource
One department with its version and members.
- List departmentsSource
Company departments with assigned employees and contractors.
- Rename departmentDestinationProvider duplicate protectionApproval before production
Renames a department (optimistic locking by version).
Earning types3
- Create earning typeDestinationProvider duplicate protectionApproval before production
Creates a custom earning type, or reactivates an inactive one with the same name.
- List earning typesSource
Default and custom earning types used on payroll lines.
- Rename earning typeDestinationProvider duplicate protectionApproval before production
Renames a custom earning type.
Employees3
- Get employeeSource
One employee with the version needed for updates.
- List employeesSource
Employees with jobs, department, status and custom fields.
- Update employeeDestinationProvider duplicate protectionApproval before production
Updates an employee's name, emails or phone (optimistic locking by version).
Employment history1
- List employment historySource
Hire and termination dates of each employment period of an employee.
Jobs2
- Get jobSource
One job by ID.
- List employee jobsSource
Jobs of one employee with title, location and current rate.
Locations4
- Create locationDestinationNot retried automaticallyApproval before production
Creates a company work, mailing or filing location.
- Get locationSource
One company location with the version needed for updates.
- List locationsSource
Company work and filing locations.
- Update locationDestinationProvider duplicate protectionApproval before production
Updates a company location (optimistic locking by version).
Minimum wages1
- List location minimum wagesSource
Federal, state and local minimum wage rules that apply to a location.
Pay periods1
- List pay periodsSource
Pay period dates with the payroll that covers each (no amounts).
Pay schedules2
- Get pay scheduleSource
One pay schedule with frequency and anchor dates.
- List pay schedulesSource
Pay frequencies and anchor dates.
Payrolls2
- Get payrollSource
One payroll with totals (read only).
- List payrollsSource
Processed or upcoming payrolls with totals (read only).
Time off activities1
- List time-off activitiesSource
Accruals, usage and balance changes for one employee.
Time off policies2
- Get time-off policySource
One time-off policy with accrual rules and enrolled employees.
- List time-off policiesSource
Vacation, sick and other policies with accrual rules.
Time off requests1
- List time-off requestsSource
Employee time-off requests with status and hours per day.
Time sheets4
- Create time sheetDestinationNot retried automaticallyApproval before production
Records a shift and its hours for an employee or contractor.
- Get time sheetSource
One time sheet with entries and version.
- List time sheetsSourceIncremental
Hours worked by employees and contractors by pay classification.
- Update time sheetDestinationProvider duplicate protectionApproval before production
Updates a time sheet's shift or hours (optimistic locking by version).
Work addresses4
- Assign work locationDestinationNot retried automaticallyApproval before production
Records that an employee works at a company location from a date.
- Get work addressSource
One employee work address with its version.
- List employee work addressesSource
Company locations an employee works at, with effective dates.
- Update work addressDestinationProvider duplicate protectionApproval before production
Changes the location or effective date of a work address.
Access and limits
- 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, companies:write, company_admin:read, employees:read, employees:write, employees:manage, employments:read, jobs:read, compensations:read, departments:read, departments:write, contractors:read, contractors:write, time_off_policies:read, time_off_requests:read, employee_time_off_activities:read, payrolls:read, payrolls:write (earning types only), pay_schedules:read, benefits:read, company_benefits:read, time_sheet:read and time_sheet:write.
- 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. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Gusto has no updated-since filter for employees; flows read the full list.
- Payrolls, compensations, time off, pay schedules, pay periods and benefits are read only. Nexra never creates, prepares, calculates or submits payroll, runs payroll syncs, or writes compensation. The payroll writes scope is used only for earning types.
- Compensation rates and payroll totals are returned as before (read-only finance reporting).
- Excluded by policy: employee and contractor creation (onboarding and portal invitations), terminations, rehires, offboarding, contractor payments, payroll and payroll-sync runs, compensation and benefit enrolment writes, garnishments, home addresses, tax and bank data, forms and documents, and every delete.
- Contractor updates send only names, business name and work email; personal email is not updated because it is the address Gusto uses for onboarding invitations.
- Department membership can be added; removal is not automated.
- 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, location, work-address and time-sheet creation have no idempotency key, so uncertain creates are not repeated; Gusto rejects duplicate department names.
Developer reference
- Create the Gusto, Inc. credentials described above with the narrowest permissions your flows need.
- 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
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/gusto and the Connections API.