Tools

Manage Contractor Payment

List contractor payments grouped by contractor and returned as individual payments. Creating or cancelling payments requires an approved Embedded Payroll application with payrolls:run. Use get_current_context to discover the authorized company.

List Contractors

List contractors (1099 workers) for a company. Returns contractor profiles including names, types, and status.

List Employees

List employees for a company. Supports filtering by termination status and pagination. Returns employee profiles including names, emails, and employment details.

Manage Company Location

List, create, or update company locations. Locations are used for tax jurisdiction purposes and employee work addresses.

Process Payroll

Request asynchronous payroll calculation or submission for an approved Embedded Payroll company. Gusto app integrations cannot run payroll. A successful response confirms acceptance; use get_payroll to verify the eventual processing outcome.

Get Payroll

Retrieve detailed information about a specific payroll, including employee compensations, taxes, deductions, and totals.

Manage Garnishment

List, create, or update wage garnishments for an employee. Supports ordinary garnishments with exact amounts and schedules; specialized child-support setup must be completed in Gusto.

Manage Employee

Create, update, retrieve, terminate, or rehire a W-2 employee. - To **create**: provide companyId, firstName, lastName, and optionally other fields. - To **get** or **update**: provide employeeId and any fields to update. - To **terminate**: provide employeeId and termination details. - To **rehire**: provide employeeId and rehire details.

Manage Job & Compensation

Manage employee jobs and compensations. Job list/create/update endpoints require an approved Embedded Payroll application. List jobs for an employee, create/update jobs, and manage compensation details (rate, payment unit, FLSA status). Jobs represent positions held by an employee, and each job can have multiple compensations with effective dating.

Manage Company Benefit

List, create, retrieve, or update company-level benefit types (health insurance, 401(k), HSA, etc.). Company benefits define the benefit plans available to employees.

Manage Department

List, create, or update departments for a company. Departments help organize employees and can be used for reporting and payroll categorization.

List Forms

List company or employee form metadata, or retrieve one form by ID. These endpoints require an approved Embedded Payroll application and company_forms:read or employee_forms:read. No form content or signing operation is returned.

List Pay Schedules

List pay schedules for a company. Pay schedules define the frequency and timing of payroll runs (weekly, biweekly, semi-monthly, monthly).

Manage Time off

List time off policies for a company or retrieve an employee's time off activity for one exact type. Use company policies to identify the exact timeOffType required for get_balances.

Manage Earning Type

List, create, or update custom earning types for a company. Earning types define categories of compensation (e.g., bonuses, commissions, tips) beyond standard types.

Manage Employee Benefit

List, create, or update employee benefit enrollments. Enrolls employees in company-defined benefit plans with specified contribution amounts and deduction settings.

List Payrolls

List payrolls for a company. Can filter by processing status and date range. Returns payroll summaries including pay period, status, and totals.

Get Current Context

Discover the current Gusto token resource, resource owner, granted scopes and company UUID. Each OAuth grant targets one company; use this companyId in other tools. Name and email are omitted when the provider does not expose them.

Get Company

Retrieve detailed information about a Gusto company, including its profile, locations, and configuration. Use this to look up company details by company ID.

Manage Contractor

Create, retrieve, or update a contractor (1099 worker). - To **create**: provide companyId, type, and contractor details. - To **get**: provide contractorId. - To **update**: provide contractorId and fields to change.