- Category: human resources
- Auth: OAUTH2
- Composio-managed OAuth available? No
- Tools: 192
- Triggers: 0
- Slug:
GUSTO - Version: 20261101_00
Tools
Add Employees to Holiday Pay Policy
Add Employees to Holiday Pay Policy
GUSTO_ADD_EMPLOYEES_TO_HOLIDAY_PAY_POLICYTool to add employees to a company’s holiday pay policy in Gusto. Use when you need to add one or more employees to the holiday pay policy scope.Input Parameters
Output
Add Employees to Time Off Policy
Add Employees to Time Off Policy
GUSTO_ADD_EMPLOYEES_TO_TIME_OFF_POLICYTool to add employees to a time off policy in Gusto. Use when you need to assign employees to an existing vacation or sick leave policy. Employees must have at least one job to be added. Accepts starting balances for non-unlimited policies.Input Parameters
Output
Add People to Department
Add People to Department
GUSTO_ADD_PEOPLE_TO_DEPARTMENTTool to add employees and contractors to a department in Gusto. Use when you need to assign people to a specific department for organizational structure.Input Parameters
Output
Assign Pay Schedules
Assign Pay Schedules
GUSTO_ASSIGN_PAY_SCHEDULESTool to assign employees to pay schedules in Gusto. Use when you need to set up or update which pay schedule employees follow. For single assignments, provide default_pay_schedule_uuid. For by_employee or by_department assignments, use partial_assignment=true for partial updates or false for full assignments.Input Parameters
Output
Calculate Accruing Time Off Hours
Calculate Accruing Time Off Hours
GUSTO_CALCULATE_ACCRUING_TIME_OFF_HOURSTool to calculate accruing time off hours for an employee based on hours worked and used in a pay period. Returns a list of accrued hours for each time off policy associated with the employee, factoring in the policy’s accrual method (per hour worked, per hour paid, with/without overtime).Input Parameters
Output
Create Admin
Create Admin
GUSTO_CREATE_ADMINTool to create a new admin for a Gusto company. Use when you need to add administrative access to a company account. If the email matches an existing user, creates an admin account for the current user, otherwise creates a new user.Input Parameters
Output
Create Time Sheet
Create Time Sheet
GUSTO_CREATE_COMPANIES_TIME_TRACKING_TIME_SHEETSTool to create a time sheet for an employee or contractor in Gusto. Use when you need to record work hours for payroll or time tracking purposes. Requires entity details, job information, and shift times.Input Parameters
Output
Create Company Bank Account
Create Company Bank Account
Create Company Benefit
Create Company Benefit
GUSTO_CREATE_COMPANY_BENEFITTool to create a company benefit in Gusto. Use when you need to add a new benefit offering (e.g., medical insurance, retirement plan) for a company.Input Parameters
Output
Create company location
Create company location
Create Company Signatory
Create Company Signatory
Create Contractor
Create Contractor
GUSTO_CREATE_CONTRACTORTool to create an individual or business contractor in Gusto. Use when you need to add a new contractor to a company’s payroll system. For individual contractors, first_name and last_name are required; for business contractors, business_name is required. Hourly contractors require hourly_rate.Input Parameters
Output
Create Contractor Bank Account
Create Contractor Bank Account
GUSTO_CREATE_CONTRACTOR_BANK_ACCOUNTCreate a contractor bank account for payments. Only one bank account per contractor is supported, so an existing account is replaced; creating the account also updates the contractor’s payment method.Input Parameters
Output
Create Department
Create Department
Create Earning Type
Create Earning Type
Create Employee
Create Employee
Create Employee Bank Account
Create Employee Bank Account
GUSTO_CREATE_EMPLOYEE_BANK_ACCOUNTTool to create an employee bank account in Gusto. Use when you need to add a new bank account for an employee. Note that creating an employee bank account will also update the employee’s payment method.Input Parameters
Output
Create Employee Benefit
Create Employee Benefit
GUSTO_CREATE_EMPLOYEE_BENEFITTool to enroll an employee in a company benefit in Gusto. Use when you need to add a benefit enrollment for an employee, specifying deductions, contributions, and coverage details.Input Parameters
Output
Create Employee Rehire
Create Employee Rehire
GUSTO_CREATE_EMPLOYEE_REHIRETool to create an employee rehire in Gusto. Use when an employee is scheduled to return to the company after being terminated or dismissed. Requires the employee UUID, effective return date, work location, and whether to file a new hire report.Input Parameters
Output
Create Employee Work Address
Create Employee Work Address
Create Employee YTD Benefit Amounts
Create Employee YTD Benefit Amounts
Create flows
Create flows
GUSTO_CREATE_FLOWSTool to generate a link to access a pre-built workflow in Gusto white-label UI. Use when you need to create onboarding flows, employee setup flows, or other company workflows. For security, all generated flows expire within 1 hour of inactivity or 24 hours from creation time.Input Parameters
Output
Create Garnishment
Create Garnishment
GUSTO_CREATE_GARNISHMENTSTool to create a garnishment (employee deduction) in Gusto. Use when you need to add fixed amounts or percentages deducted from an employee’s pay, such as court-ordered payments, loan repayments, or other deductions.Input Parameters
Output
Create Historical Employee
Create Historical Employee
GUSTO_CREATE_HISTORICAL_EMPLOYEETool to create a historical employee in Gusto. Use when you need to add an employee who was previously dismissed from the company in the current year. Requires personal information (name, DOB, SSN), addresses (home and work location UUID), job hire date, and termination effective date.Input Parameters
Output
Create Holiday Pay Policy
Create Holiday Pay Policy
GUSTO_CREATE_HOLIDAY_PAY_POLICYTool to create a holiday pay policy for a company in Gusto. Use when you need to define which federal holidays will be paid holidays for a company’s employees.Input Parameters
Output
Create Job
Create Job
GUSTO_CREATE_JOBTool to create a job for an employee in Gusto. Use when you need to add a new job or position for an existing employee in the payroll system.Input Parameters
Output
Create job compensation
Create job compensation
GUSTO_CREATE_JOB_COMPENSATIONTool to create a compensation for a job in Gusto. Use when you need to set up payment details (rate, payment unit, FLSA status) for an employee’s job.Input Parameters
Output
Create Payroll General Ledger Report
Create Payroll General Ledger Report
GUSTO_CREATE_PAYROLL_GENERAL_LEDGER_REPORTTool to create a general ledger report for a payroll with optional aggregation by job, department, or integration type. Use when you need accounting entries for a payroll run. The report is generated asynchronously; use the returned request_uuid to poll for completion and retrieve the JSON report.Input Parameters
Output
Create Pay Schedule Assignment Preview
Create Pay Schedule Assignment Preview
GUSTO_CREATE_PAY_SCHEDULES_ASSIGNMENT_PREVIEWTool to preview employee pay schedule assignment changes for a company. Use when you need to see how changing pay schedules will affect employees’ pay periods and transition periods before applying the changes.Input Parameters
Output
Create Custom Report
Create Custom Report
GUSTO_CREATE_REPORTSTool to create a custom report for a company with custom columns, groupings, and filters. Use when you need to generate payroll, employee, or tax reports with specific data fields. The request_uuid in the response can be used to poll for the status and report URL upon completion. Report URLs are valid for 10 minutes.Input Parameters
Output
Create Employees Annual FICA Wage Report
Create Employees Annual FICA Wage Report
GUSTO_CREATE_REPORTS_EMPLOYEES_ANNUAL_FICA_WAGETool to generate an annual FICA wage report for all employees in a company over a specified year range. Use when you need detailed wage information subject to Social Security and Medicare taxes for benefits integrations or compliance verification. The report is generated asynchronously; use the returned request_uuid to poll for completion.Input Parameters
Output
Create Section 603 High Earner Status
Create Section 603 High Earner Status
GUSTO_CREATE_SECTION603_HIGH_EARNER_STATUSTool to create a Section 603 high earner status for an employee in Gusto. Use when you need to designate whether an employee qualifies as a high earner under Section 603 of the SECURE 2.0 Act for a specific year.Input Parameters
Output
Create Time Off Policy
Create Time Off Policy
GUSTO_CREATE_TIME_OFF_POLICYTool to create a time off policy in Gusto for a company. Use when you need to set up vacation or sick leave policies with specific accrual methods and limits. The policy can be configured with accrual rates, maximum hours, carryover limits, and termination payout rules.Input Parameters
Output
Deactivate Earning Type
Deactivate Earning Type
Deactivate Time Off Policy
Deactivate Time Off Policy
GUSTO_DEACTIVATE_TIME_OFF_POLICYTool to deactivate a time off policy in Gusto. Use when you need to disable or remove a vacation or sick leave policy from active use. Note: The policy cannot be deactivated if there are pending time off requests.Input Parameters
Output
Delete Company Bank Account
Delete Company Bank Account
Delete Company Holiday Pay Policy
Delete Company Holiday Pay Policy
Delete Compensation
Delete Compensation
Delete Contractor
Delete Contractor
Delete Department
Delete Department
GUSTO_DELETE_DEPARTMENTTool to delete a department in Gusto. Use when you need to permanently remove a department. All employees and contractors must be removed from the department before deletion.Input Parameters
Output
Delete Employee
Delete Employee
Delete Employee Bank Account
Delete Employee Bank Account
Delete Employee Benefit
Delete Employee Benefit
Delete Employee Home Address
Delete Employee Home Address
Delete Employee Termination
Delete Employee Termination
Delete Job
Delete Job
Delete Time Tracking Time Sheet
Delete Time Tracking Time Sheet
Delete Work Address
Delete Work Address
Download Employee Forms PDF
Download Employee Forms PDF
Download Company Forms PDF
Download Company Forms PDF
Finish company onboarding
Finish company onboarding
Get Benefit
Get Benefit
Get Company Departments
Get Company Departments
Get company
Get company
Get Company Attachment Download URL
Get Company Attachment Download URL
Get Company Benefit
Get Company Benefit
GUSTO_GET_COMPANY_BENEFITTool to retrieve a specific company benefit by its UUID. Use when you need to get detailed information about a company benefit, including employee participation if requested.Input Parameters
Output
Get Company Earning Types
Get Company Earning Types
Get company holiday pay policy
Get company holiday pay policy
Get Company Locations
Get Company Locations
Get company onboarding status
Get company onboarding status
GUSTO_GET_COMPANY_ONBOARDING_STATUSTool to retrieve a company’s onboarding status from Gusto. Use when you need to check if a company has completed onboarding and view the status of individual onboarding steps.Input Parameters
Output
Get company report template
Get company report template
Get Company Suspensions
Get Company Suspensions
Get compensation
Get compensation
Get Contractor
Get Contractor
Get Contractor Address
Get Contractor Address
GUSTO_GET_CONTRACTOR_ADDRESSTool to retrieve a contractor’s address from Gusto. Use when you need to get the current address information for a contractor. The address is used to determine certain tax information and is geocoded to ensure validity.Input Parameters
Output
Get Contractor Bank Accounts
Get Contractor Bank Accounts
Get Contractor Document
Get Contractor Document
Get Contractor Document PDF
Get Contractor Document PDF
Get Contractor Payment Groups
Get Contractor Payment Groups
GUSTO_GET_CONTRACTOR_PAYMENT_GROUPSTool to get contractor payment groups for a company. Use when you need to retrieve payment groups for contractors within a specific time period. Returns groups with submission and credit blockers but without individual contractor payments.Input Parameters
Output
Get Contractor Payments
Get Contractor Payments
GUSTO_GET_CONTRACTOR_PAYMENTSTool to retrieve contractor payments for a company within a specified date range. Use when you need to fetch payment information for contractors, optionally filtered by specific contractor or date grouping.Input Parameters
Output
Get Department
Get Department
Get employee
Get employee
GUSTO_GET_EMPLOYEERetrieve detailed information about an employee by UUID, including personal details, job information, compensation, eligible paid time off, and employment status.Input Parameters
Output
Get Employee All Benefits
Get Employee All Benefits
GUSTO_GET_EMPLOYEE_ALL_BENEFITSTool to get all benefits for a specific employee by their UUID. Use when you need to retrieve all benefit enrollments for an employee, including contribution amounts, deduction details, and coverage information.Input Parameters
Output
Get Employee Bank Accounts
Get Employee Bank Accounts
GUSTO_GET_EMPLOYEE_BANK_ACCOUNTSTool to retrieve all bank accounts for a specific employee. Use when you need to view an employee’s banking details for payroll processing or direct deposit setup.Input Parameters
Output
Get Employee Benefit
Get Employee Benefit
GUSTO_GET_EMPLOYEE_BENEFITTool to retrieve a specific employee benefit enrollment by UUID. Use when you need to get detailed information about an employee’s enrollment in a company benefit, including contribution amounts, deduction details, and coverage information. Benefits containing PHI require the employee_benefits:read:phi scope.Input Parameters
Output
Get employee federal taxes
Get employee federal taxes
GUSTO_GET_EMPLOYEE_FEDERAL_TAXESTool to retrieve an employee’s federal tax withholding information including W4 details. Use when you need to access federal tax configuration for a specific employee. The response format varies based on whether the employee is using pre-2020 or 2020+ W4 form.Input Parameters
Output
Get Employee Form
Get Employee Form
Get employee jobs
Get employee jobs
GUSTO_GET_EMPLOYEE_JOBSTool to retrieve all jobs for a specific employee in Gusto. Use when you need to get job information including titles, locations, compensation details, and employment history for an employee.Input Parameters
Output
Get Employee Payment Method
Get Employee Payment Method
Get employee pay stub
Get employee pay stub
Get Employee Recurring Reimbursements
Get Employee Recurring Reimbursements
GUSTO_GET_EMPLOYEE_RECURRING_REIMBURSEMENTSGet active recurring reimbursements for a specific employee, with optional pagination.Input Parameters
Output
Get employee state taxes
Get employee state taxes
Get federal tax details
Get federal tax details
Get Company Form
Get Company Form
Get Garnishment
Get Garnishment
Get Home Address
Get Home Address
Get job
Get job
Get location
Get location
Get Notification
Get Notification
Get payroll
Get payroll
GUSTO_GET_PAYROLLRetrieve a single payroll by company and payroll UUID, including employee compensations and totals if calculated or processed. Employee compensations are paginated.Input Parameters
Output
Get payroll receipt
Get payroll receipt
Get pay schedule
Get pay schedule
Get People Batches
Get People Batches
Get Recurring Reimbursement
Get Recurring Reimbursement
Get report
Get report
GUSTO_GET_REPORTSTool to get a company’s report given the request_uuid. Returns the report request’s status and, if complete, the report URL. Use when you need to check the status of a report generation request or retrieve the completed report URL.Input Parameters
Output
Get salary estimate
Get salary estimate
Get state tax requirements
Get state tax requirements
GUSTO_GET_STATE_TAX_REQUIREMENTSTool to retrieve state-specific tax requirements for a company in Gusto. Use when you need to access required tax configuration fields for a specific US state including withholding details, account numbers, and filing information.Input Parameters
Output
Get Company Benefit Summary
Get Company Benefit Summary
GUSTO_GET_SUMMARY_COMPANY_BENEFITS_SUMMARYTool to retrieve summary benefit data for a specific company benefit. Returns aggregate contribution and deduction amounts for a given time period. Use when you need to analyze benefit costs, employee participation, or financial reporting for a specific company benefit.Input Parameters
Output
Get Tax Liabilities
Get Tax Liabilities
Get Time Off Policy
Get Time Off Policy
Get time tracking time sheet
Get time tracking time sheet
GUSTO_GET_TIME_TRACKING_TIME_SHEETTool to fetch a time sheet by UUID. Time sheets represent the time worked by an employee or contractor for a given time range with hours classified by pay classification (regular, overtime, or double overtime). Use when you need detailed information about a specific time sheet.Input Parameters
Output
Get token info
Get token info
Get Work Address
Get Work Address
Invite Signatory
Invite Signatory
List ACH Transactions
List ACH Transactions
GUSTO_LIST_ACH_TRANSACTIONSRetrieve ACH transactions for a company to view payment transactions, track statuses, or analyze payroll and contractor payment movements. Supports filters and pagination; a request may return only one page.Input Parameters
Output
List Company Attachments
List Company Attachments
List Benefits
List Benefits
List Benefits Requirements
List Benefits Requirements
List Company Custom Fields
List Company Custom Fields
List Companies Time Off Requests
List Companies Time Off Requests
List Company Bank Accounts
List Company Bank Accounts
List Company Benefits
List Company Benefits
GUSTO_LIST_COMPANY_BENEFITSTool to retrieve all benefits offered by a company. Use when you need to list available company benefits, check benefit statuses, or see employee enrollment information. Company benefits represent the benefits that a company offers to employees and can be filtered by active status or benefit type.Input Parameters
Output
List Company Benefits Contribution Exclusions
List Company Benefits Contribution Exclusions
GUSTO_LIST_COMPANY_BENEFITS_CONTRIBUTION_EXCLUSIONSTool to retrieve all contributions for a given company benefit and whether they are excluded or not. Use when you need to check which contribution types are excluded from a specific benefit. Currently only works for 401-k and Roth 401-k benefit types.Input Parameters
Output
List Company Benefits Employee Benefits
List Company Benefits Employee Benefits
GUSTO_LIST_COMPANY_BENEFITS_EMPLOYEE_BENEFITSList employee benefits for a specific company benefit, including enrollment, contribution, deduction, and coverage details when returned. Results can be requested by page.Input Parameters
Output
List Company Forms
List Company Forms
GUSTO_LIST_COMPANY_FORMSTool to get a list of all company’s forms. Use when you need to retrieve all forms associated with a specific company, including tax forms and other company documents.Input Parameters
Output
List Contractor Documents
List Contractor Documents
List Contractor Forms
List Contractor Forms
List contractor onboarding status
List contractor onboarding status
List Contractor Payment Details
List Contractor Payment Details
GUSTO_LIST_CONTRACTOR_PAYMENT_DETAILSTool to get payment details for contractors in a company, including their payment methods and bank account details for direct deposit. Use when you need to retrieve contractor payment information such as bank routing numbers, account details, or payment split configurations.Input Parameters
Output
List Contractor Payment Method
List Contractor Payment Method
List Contractors
List Contractors
GUSTO_LIST_CONTRACTORSTool to get all contractors for a company including individuals and businesses. Use when you need to retrieve contractor information, filter by onboarding or termination status, or search for specific contractors by name.Input Parameters
Output
List Employee Custom Fields
List Employee Custom Fields
List Employee Forms
List Employee Forms
List Employee Home Addresses
List Employee Home Addresses
GUSTO_LIST_EMPLOYEE_HOME_ADDRESSESTool to get an employee’s home addresses. The home address is used to determine certain tax information and supports effective dating and courtesy withholding. Use when you need to retrieve address information for tax purposes or employee records.Input Parameters
Output
List employee onboarding status
List employee onboarding status
List Employees
List Employees
GUSTO_LIST_EMPLOYEESList employees for a company, including onboarding, active, and terminated employees. Supports filtering, search, sorting, and pagination; a request returns one page when pagination applies.Input Parameters
Output
List Employee Work Addresses
List Employee Work Addresses
List Employment History
List Employment History
List Child Support Agencies
List Child Support Agencies
List Information Requests
List Information Requests
List job compensations
List job compensations
GUSTO_LIST_JOBS_COMPENSATIONSTool to retrieve all compensations for a specific job in Gusto. Use when you need information on how much is paid out for a job. Jobs may have many compensations, but only one that is active. By default returns only the current compensation.Input Parameters
Output
List migration readiness
List migration readiness
List Minimum Wages
List Minimum Wages
List Notifications
List Notifications
GUSTO_LIST_NOTIFICATIONSTool to retrieve all notifications relevant for a company. Returns notifications that can be filtered by status (open, expired, resolved). Use when you need to check pending actions, critical alerts, or payroll blockers for a company.Input Parameters
Output
List Paid Holidays
List Paid Holidays
GUSTO_LIST_PAID_HOLIDAYSTool to retrieve a company’s paid holidays from Gusto. Use when you need to preview the paid holidays for a company based on their holiday pay policy.Input Parameters
Output
List Employee Payment Details
List Employee Payment Details
GUSTO_LIST_PAYMENT_DETAILSTool to fetch payment details for employees in a company including payment methods and bank account details. Use when you need to retrieve employee payment information such as bank routing numbers, account details, or payment split configurations.Input Parameters
Output
List Pay Periods
List Pay Periods
GUSTO_LIST_PAY_PERIODSTool to retrieve pay periods for a company. Pay periods are the foundation of payroll and are used for compensation, time & attendance, taxes, and expense reports. Use when you need to get pay period information for submitting payroll data.Input Parameters
Output
List Payroll Blockers
List Payroll Blockers
List Payroll Reversals
List Payroll Reversals
GUSTO_LIST_PAYROLL_REVERSALSTool to retrieve all approved payroll reversals for a company. Use when you need to view reversals that have been applied to previous payroll runs.Input Parameters
Output
List pay schedules
List pay schedules
GUSTO_LIST_PAY_SCHEDULESTool to retrieve all pay schedules for a company. Use when you need to get information about when employees work and when they should be paid for a specific company.Input Parameters
Output
List pay schedules assignments
List pay schedules assignments
List pay schedules preview
List pay schedules preview
GUSTO_LIST_PAY_SCHEDULES_PREVIEWTool to preview pay schedule dates with specified parameters for the next 18 months. Use when you need to see upcoming pay dates, pay periods, and bank holidays for a proposed pay schedule configuration before creating it.Input Parameters
Output
List Pay Stubs
List Pay Stubs
GUSTO_LIST_PAY_STUBSTool to get an employee’s pay stubs including payment details and amounts. Use when you need to retrieve pay stub information for a specific employee.Input Parameters
Output
List Recovery Cases
List Recovery Cases
GUSTO_LIST_RECOVERY_CASESTool to fetch all recovery cases for a company. Use when you need to retrieve recovery case information including status, outstanding amounts, and associated payroll or contractor payment details. Recovery cases track failed ACH transactions that require recovery.Input Parameters
Output
List Signatories
List Signatories
List Tax Requirements
List Tax Requirements
List Time Off Activities
List Time Off Activities
List Time Off Policies
List Time Off Policies
List Time Tracking Time Sheets
List Time Tracking Time Sheets
GUSTO_LIST_TIME_TRACKING_TIME_SHEETSList a company’s time sheets representing time worked by employees or contractors, including regular, overtime, and double overtime hours. Supports page and page-size parameters.Input Parameters
Output
List unprocessed termination pay periods
List unprocessed termination pay periods
List Wire In Requests
List Wire In Requests
List YTD Benefit Amounts From Different Company
List YTD Benefit Amounts From Different Company
GUSTO_LIST_YTD_BENEFIT_AMOUNTS_FROM_DIFFERENT_COMPANYTool to retrieve year-to-date benefit amounts contributed at a different company for an employee. Returns benefit amounts for the requested tax year (defaults to current year if not specified). This endpoint only supports retrieving outside contributions for 401(k) benefits.Input Parameters
Output
Remove Employees from Holiday Pay Policy
Remove Employees from Holiday Pay Policy
GUSTO_REMOVE_HOLIDAY_PAY_POLICY_EMPLOYEESTool to remove employees from a company’s holiday pay policy in Gusto. Use when you need to exclude specific employees from the holiday pay policy scope.Input Parameters
Output
Remove People From Department
Remove People From Department
GUSTO_REMOVE_PEOPLE_FROM_DEPARTMENTTool to remove employees and contractors from a department in Gusto. Use when you need to unassign people from a department.Input Parameters
Output
Remove Employees from Time Off Policy
Remove Employees from Time Off Policy
GUSTO_REMOVE_TIME_OFF_POLICY_EMPLOYEESTool to remove employees from a time off policy in Gusto. Use when you need to exclude specific employees from a vacation or sick leave policy scope.Input Parameters
Output
Retrieve Terms of Service Status
Retrieve Terms of Service Status
GUSTO_RETRIEVE_TERMS_OF_SERVICE_STATUSTool to retrieve the user acceptance status of Gusto Embedded Payroll’s Terms of Service. Use when you need to check if a specific user has accepted the latest terms of service for a company.Input Parameters
Output
Update Company
Update Company
GUSTO_UPDATE_COMPANYUpdate a Gusto company’s contractor-only flag to support W-2 employees.Input Parameters
Output
Update Company Benefit Contribution Exclusions
Update Company Benefit Contribution Exclusions
GUSTO_UPDATE_COMPANY_BENEFIT_CONTRIBUTION_EXCLUSIONSTool to update contribution exclusions for a company benefit in Gusto. Use when you need to specify which contribution types should be excluded from a specific benefit. Currently only works for 401-k and Roth 401-k benefit types.Input Parameters
Output
Update Company Benefit
Update Company Benefit
GUSTO_UPDATE_COMPANY_BENEFITSTool to update an existing company benefit in Gusto. Use when you need to modify benefit details such as description, active status, or other attributes. Note that company benefits can be deactivated only when no employees are enrolled.Input Parameters
Output
Update Contractor Address
Update Contractor Address
GUSTO_UPDATE_CONTRACTOR_ADDRESSTool to create or update a contractor’s address in Gusto. Use when you need to set or modify the home address information for an existing contractor. Requires the contractor’s UUID and the current version for optimistic locking.Input Parameters
Output
Update Contractor Payment Method
Update Contractor Payment Method
GUSTO_UPDATE_CONTRACTOR_PAYMENT_METHODTool to update a contractor’s payment method in Gusto. Use when you need to change how a contractor receives payments (Check or Direct Deposit). For Direct Deposit, you’ll need to configure bank account splits separately.Input Parameters
Output
Update Department
Update Department
GUSTO_UPDATE_DEPARTMENTTool to update a department in Gusto. Use when you need to modify department details like the title. Requires the current version for optimistic locking.Input Parameters
Output
Update Earning Type
Update Earning Type
Update Employee
Update Employee
GUSTO_UPDATE_EMPLOYEEUpdate an employee in Gusto, including information such as name, email, SSN, or shareholder status. Requires the employee’s current version.Input Parameters
Output
Update Employee Bank Account
Update Employee Bank Account
Update Employee Benefit
Update Employee Benefit
GUSTO_UPDATE_EMPLOYEE_BENEFITTool to update an individual employee benefit by its UUID in Gusto. Use when you need to modify benefit details like deduction amounts, company contributions, coverage, or dates for a specific employee’s benefit enrollment. Requires the benefit UUID and version for optimistic locking.Input Parameters
Output
Update Employee Benefits
Update Employee Benefits
GUSTO_UPDATE_EMPLOYEE_BENEFITSTool to bulk update or create employee benefits for a company benefit in Gusto. Use when you need to enroll employees in a benefit plan or modify existing enrollments.Input Parameters
Output
Update Employee Onboarding Status
Update Employee Onboarding Status
GUSTO_UPDATE_EMPLOYEE_ONBOARDING_STATUSTool to update the onboarding status of an employee in Gusto. Use when you need to change an employee’s progress through the onboarding process. Note that invalid status transitions will return a 422 error.Input Parameters
Output
Update Employee Payment Method
Update Employee Payment Method
GUSTO_UPDATE_EMPLOYEE_PAYMENT_METHODTool to update an employee’s payment method in Gusto. Use when you need to change how an employee receives payments (Check or Direct Deposit). For Direct Deposit, you must also specify split_by and splits to configure bank account distribution.Input Parameters
Output
Update Employee Rehire
Update Employee Rehire
GUSTO_UPDATE_EMPLOYEE_REHIRETool to update an employee rehire in Gusto. Use when you need to modify the details of a pending rehire for a terminated employee.Input Parameters
Output
Update Employee Termination
Update Employee Termination
GUSTO_UPDATE_EMPLOYEE_TERMINATIONTool to update an existing employee termination in Gusto. Use when you need to modify the effective date or payroll settings for a scheduled termination. Requires the current version for optimistic locking.Input Parameters
Output
Update Federal Tax Details
Update Federal Tax Details
GUSTO_UPDATE_FEDERAL_TAX_DETAILSTool to update federal tax details for a company in Gusto. Use when you need to update attributes relevant for federal taxes such as EIN, filing form, legal name, tax payer type, or S-Corporation election.Input Parameters
Output
Update Employee Federal Taxes
Update Employee Federal Taxes
GUSTO_UPDATE_FEDERAL_TAXESUpdate an employee’s federal tax information in Gusto, including W-4 filing status and withholding details. Gusto accepts only the revised 2020 W-4 format for updates.Input Parameters
Output
Update Garnishment
Update Garnishment
GUSTO_UPDATE_GARNISHMENTTool to update an existing garnishment in Gusto. Use when you need to modify garnishment details such as amount, description, or child support information. Requires the garnishment UUID and the current version for optimistic locking.Input Parameters
Output
Update Historical Employee
Update Historical Employee
GUSTO_UPDATE_HISTORICAL_EMPLOYEETool to update a historical employee in Gusto. Historical employees are employees that were previously dismissed from the company in the current year. Use when you need to update information for a terminated employee.Input Parameters
Output
Update Holiday Pay Policy
Update Holiday Pay Policy
GUSTO_UPDATE_HOLIDAY_PAY_POLICYTool to update a company’s holiday pay policy in Gusto. Use when you need to configure which federal holidays are included in the company’s holiday pay policy.Input Parameters
Output
Update Home Address
Update Home Address
GUSTO_UPDATE_HOME_ADDRESSTool to update an employee’s home address in Gusto. Use when you need to change an employee’s residential address details.Input Parameters
Output
Update Company Industry Selection
Update Company Industry Selection
GUSTO_UPDATE_INDUSTRY_SELECTIONTool to update the industry classification for a company by providing a NAICS code. Use when you need to set or change a company’s industry classification in Gusto’s payroll system.Input Parameters
Output
Update Jobs
Update Jobs
GUSTO_UPDATE_JOBSTool to update a job in Gusto. Use when you need to modify job details such as title, hire date, workers’ compensation settings, or shareholder status. Requires the current version for optimistic locking.Input Parameters
Output
Update location
Update location
GUSTO_UPDATE_LOCATIONTool to update an existing location in Gusto. Use when you need to modify address details, phone number, or filing/mailing address status for a location. Requires the current version for optimistic locking.Input Parameters
Output
Update Onboarding Documents Config
Update Onboarding Documents Config
GUSTO_UPDATE_ONBOARDING_DOCUMENTS_CONFIGTool to update an employee’s onboarding documents configuration in Gusto. Use when you need to indicate whether to include Form I-9 during employee onboarding.Input Parameters
Output
Update pay schedule
Update pay schedule
GUSTO_UPDATE_PAY_SCHEDULETool to update a pay schedule in Gusto. Use when you need to modify pay schedule settings such as custom name, anchor dates, frequency, or auto-payroll configuration.Input Parameters
Output
Update recurring reimbursement
Update recurring reimbursement
GUSTO_UPDATE_RECURRING_REIMBURSEMENTTool to update an existing recurring reimbursement in Gusto. Use when you need to modify the amount or description of a recurring reimbursement. Requires the current version for optimistic locking.Input Parameters
Output
Update Salary Estimate
Update Salary Estimate
GUSTO_UPDATE_SALARY_ESTIMATETool to update a salary estimate for an S-Corp owner in Gusto. Use when you need to modify occupation details, location, or business revenue for salary calculations. Cannot update if the estimate has already been finalized.Input Parameters
Output
Update Section 603 High Earner Status
Update Section 603 High Earner Status
GUSTO_UPDATE_SECTION603_HIGH_EARNER_STATUSTool to update an employee’s Section 603 high earner status for a specific year. Use when you need to set or modify whether an employee is classified as a high earner under Section 603 of the SECURE 2.0 Act, which affects their retirement contribution tax treatment.Input Parameters
Output
Update State Taxes
Update State Taxes
GUSTO_UPDATE_STATE_TAXESTool to update state tax attributes for an employee in Gusto. Use when you need to update state-specific tax information such as withholding exemptions or additional withholding amounts. Answers must be supplied in effective-dated format with valid_from=‘2010-01-01’ and valid_up_to=null.Input Parameters
Output
Update State Tax Requirements
Update State Tax Requirements
GUSTO_UPDATE_STATE_TAX_REQUIREMENTSTool to update state tax requirements for a company in Gusto. Use when you need to update state-specific tax settings such as tax rates, unemployment insurance rates, or other state tax compliance requirements.Input Parameters
Output
Update time off policy balance
Update time off policy balance
GUSTO_UPDATE_TIME_OFF_POLICIES_BALANCETool to update time off hours balances for employees under a time off policy. Use when you need to set or adjust employee vacation or sick leave balances for a specific policy. Requires the time_off_policies:write scope.Input Parameters
Output
Update Time Off Policy
Update Time Off Policy
GUSTO_UPDATE_TIME_OFF_POLICYTool to update a time off policy in Gusto. Use when you need to modify vacation or sick leave policy settings such as accrual rates, limits, carryover rules, or termination payout configuration. Requires the policy version for optimistic locking.Input Parameters
Output
Update Time Tracking Time Sheet
Update Time Tracking Time Sheet
GUSTO_UPDATE_TIME_TRACKING_TIME_SHEETUpdate a Gusto time tracking time sheet’s shift times, time zone, and classified hours. The request requires the current version and all of these shift and hours details.Input Parameters
Output
Update Work Address
Update Work Address
GUSTO_UPDATE_WORK_ADDRESSTool to update an employee work address in Gusto. Use when you need to change an employee’s work location or effective date. Requires the version field for optimistic locking.