Every capability is a discrete, logged action the agent calls by name — scoped to what you authorize and recorded in the run trace.
Add Employees to Holiday Pay PolicyGUSTO_ADD_EMPLOYEES_TO_HOLIDAY_PAY_POLICY
Tool 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.
Add Employees to Time Off PolicyGUSTO_ADD_EMPLOYEES_TO_TIME_OFF_POLICY
Tool 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.
Add People to DepartmentGUSTO_ADD_PEOPLE_TO_DEPARTMENT
Tool to add employees and contractors to a department in Gusto. Use when you need to assign people to a specific department for organizational structure.
Assign Pay SchedulesGUSTO_ASSIGN_PAY_SCHEDULES
Tool 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.
Calculate Accruing Time Off HoursGUSTO_CALCULATE_ACCRUING_TIME_OFF_HOURS
Tool 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).
Create AdminGUSTO_CREATE_ADMIN
Tool 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.
Create Time SheetGUSTO_CREATE_COMPANIES_TIME_TRACKING_TIME_SHEETS
Tool 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.
Create Company Bank AccountGUSTO_CREATE_COMPANY_BANK_ACCOUNT
Tool to create a company bank account in Gusto. Use when you need to add a new bank account for payroll processing.
Create Company BenefitGUSTO_CREATE_COMPANY_BENEFIT
Tool 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.
Create company locationGUSTO_CREATE_COMPANY_LOCATION
Tool to create a company location in Gusto. Use when you need to add a new address for a company (mailing, filing, or work location).
Create Company SignatoryGUSTO_CREATE_COMPANY_SIGNATORY
Tool to create a new signatory for a Gusto company. Use when you need to add an authorized signatory who can sign company forms and documents.
Create ContractorGUSTO_CREATE_CONTRACTOR
Tool 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.
Create Contractor Bank AccountGUSTO_CREATE_CONTRACTOR_BANK_ACCOUNT
Tool to create a contractor bank account in Gusto. Use when you need to add a bank account for contractor payments. Note: Only one bank account per contractor is supported; using this endpoint on a contractor who already has a bank account will replace it.
Create DepartmentGUSTO_CREATE_DEPARTMENT
Tool to create a new department in a Gusto company. Use when you need to add a new department for organizational structure.
Create Earning TypeGUSTO_CREATE_EARNING_TYPES
Tool to create a custom earning type for a company in Gusto. If an inactive earning type exists with the same name, this will reactivate it instead of creating a new one.
Create EmployeeGUSTO_CREATE_EMPLOYEE
Tool to create a new employee in Gusto. Use when you need to add a new employee to a company's payroll system.
Create Employee Bank AccountGUSTO_CREATE_EMPLOYEE_BANK_ACCOUNT
Tool 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.
Tool 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.
Tool 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.
Create Employee Work AddressGUSTO_CREATE_EMPLOYEE_WORK_ADDRESS
Tool to create an employee's work address in Gusto. Use when you need to assign an employee to a specific company location with an effective date.
Tool to create year-to-date benefit amounts from a different company for an employee. Use when you need to record prior YTD benefit contributions and deductions from a previous employer.
Create flowsGUSTO_CREATE_FLOWS
Tool 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.
Create GarnishmentGUSTO_CREATE_GARNISHMENTS
Tool 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.
Tool 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.
Tool 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.
Create JobGUSTO_CREATE_JOB
Tool 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.
Tool 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.
Create Payroll General Ledger ReportGUSTO_CREATE_PAYROLL_GENERAL_LEDGER_REPORT
Tool 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.
Tool 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.
Create Custom ReportGUSTO_CREATE_REPORTS
Tool 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.
Create Employees Annual FICA Wage ReportGUSTO_CREATE_REPORTS_EMPLOYEES_ANNUAL_FICA_WAGE
Tool 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.
Create Section 603 High Earner StatusGUSTO_CREATE_SECTION603_HIGH_EARNER_STATUS
Tool 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.
Create Time Off PolicyGUSTO_CREATE_TIME_OFF_POLICY
Tool 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.
Tool to deactivate an earning type for a company. Use when you need to remove or disable an earning type from a company's payroll configuration.
Deactivate Time Off PolicyGUSTO_DEACTIVATE_TIME_OFF_POLICY
Tool 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.
Delete Company Bank AccountGUSTO_DELETE_COMPANIE_BANK_ACCOUNTS
Tool to disable a company bank account in Gusto. Use when you need to deactivate a bank account for a company. A bank account cannot be disabled if it is used for any unprocessed payments.
Delete Company Holiday Pay PolicyGUSTO_DELETE_COMPANY_HOLIDAY_PAY_POLICY
Tool to delete a company's holiday pay policy in Gusto. Use when you need to remove the holiday pay policy for a company.
Delete CompensationGUSTO_DELETE_COMPENSATION
Tool to delete a compensation by its UUID. Use when you need to remove a compensation record from Gusto.
Delete ContractorGUSTO_DELETE_CONTRACTOR
Tool to delete a contractor from Gusto. Use when you need to permanently remove a contractor from the system.
Delete DepartmentGUSTO_DELETE_DEPARTMENT
Tool 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.
Delete EmployeeGUSTO_DELETE_EMPLOYEE
Tool to delete an onboarding employee from Gusto. Use when you need to remove an employee who has not yet been onboarded.
Delete Employee Bank AccountGUSTO_DELETE_EMPLOYEE_BANK_ACCOUNT
Tool to delete an employee bank account in Gusto. Use when you need to remove a bank account from an employee's profile.
Tool to delete an employee's I-9 verification document from Gusto. Use when removing documents provided to verify identity and work authorization in the United States.
Delete JobGUSTO_DELETE_JOB
Tool to delete an individual job from Gusto. Use when you need to remove a job by its UUID.
Delete Time Tracking Time SheetGUSTO_DELETE_TIME_TRACKING_TIME_SHEET
Tool to delete a time sheet from Gusto time tracking. Use when you need to permanently remove a time sheet from the system.
Delete Work AddressGUSTO_DELETE_WORK_ADDRESS
Tool to delete an employee's work address from Gusto. Use when you need to remove a work address by its UUID.
Download Employee Forms PDFGUSTO_DOWNLOAD_EMPLOYEE_FORMS_PDF
Tool to get the link to an employee form PDF. Use when you need to retrieve or download a specific employee form document by providing the employee UUID and form UUID.
Download Company Forms PDFGUSTO_DOWNLOAD_FORMS_PDF
Tool to get the link to a company form PDF. Use when you need to retrieve or download a specific company form document by providing the form UUID.
Finish company onboardingGUSTO_FINISH_COMPANY_ONBOARDING
Tool to finish company onboarding in Gusto. Use when you need to mark a company's onboarding process as complete.
Get BenefitGUSTO_GET_BENEFIT
Tool to retrieve a benefit supported by Gusto. Returns high-level information about a particular benefit type and its tax considerations.
Get Company DepartmentsGUSTO_GET_COMPANIES_DEPARTMENTS
Tool to retrieve all departments of a company from Gusto. Use when you need to get a list of all departments, including their employees and contractors.
Get companyGUSTO_GET_COMPANY
Tool to retrieve company details from Gusto by company UUID. Use when you need to get information about a specific company including status, locations, admins, and payroll settings.
Get Company Attachment Download URLGUSTO_GET_COMPANY_ATTACHMENT_DOWNLOAD_URL
Tool to retrieve a temporary URL to download a company attachment file. Use when you need to access uploaded company documents or files.
Get Company BenefitGUSTO_GET_COMPANY_BENEFIT
Tool 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.
Get Company Earning TypesGUSTO_GET_COMPANY_EARNING_TYPES
Tool to retrieve all earning types (default and custom) for a company. Use when you need to list available earning types that can be assigned to employees for payroll purposes.
Get company holiday pay policyGUSTO_GET_COMPANY_HOLIDAY_PAY_POLICY
Tool to retrieve a company's holiday pay policy including which federal holidays are selected and which employees are covered. Use when you need to access holiday pay configuration for a company.
Get Company LocationsGUSTO_GET_COMPANY_LOCATIONS
Tool to get all company locations. Use when you need to retrieve address information for all locations associated with a specific company.