accept_reasonable_salary
ChatGPTMarks the Solo S-corp owner's in-progress reasonable-salary estimate as accepted, recording the chosen W-2 salary for IRS-defensibility purposes. Call this LAST in the Reasonable Salary Calculator flow. Before calling, confirm the user has reviewed the calculated estimate and explicitly wants to accept that number; do not call accept_reasonable_salary automatically just because a calculate_reasonable_salary call succeeded. IMPORTANT - any later change to the estimate's inputs silently clears the acceptance, so accept must be the final step. The company and owner come from the token context, never the caller, so this requires an existing company — if the account does not have one yet, call create_company first, otherwise this fails. It accepts the single most recently calculated in-progress estimate for that owner; if several calculate_reasonable_salary calls were made, only the latest can be accepted (each overwrote the previous). Pass salary to accept a specific figure the user chose from inside the estimate's range, or omit it to accept the recommended result - never pass a number the user did not name. On success, returns the accepted estimate (id, result and acceptedSalary as integer USD amounts, range, acceptedAt); acceptedSalary is the figure that was actually recorded. On failure, the response errors list names a structured kind - "no_in_progress_estimate" (calculate a reasonable salary estimate first), "company_not_eligible" (company is not taxed as an S-corp), "salary_out_of_range" (the salary passed falls outside the estimate's range; re-offer a figure inside it), or "no_draft_team_member" (owner profile not ready yet, usually a brief race after signup; retry shortly). This does NOT set the owner's actual pay rate, file any tax form, or finalize the estimate to an employee job - accepting records the number, and a later manage_company_members call is what puts it on payroll. The accepted figure comes back from get_company_onboarding_status as owner_profile.accepted_reasonable_salary, so it survives past this conversation; read it from there rather than remembering it. ONBOARDING HANDOFF — RSC is reached two ways, and acceptance means different things in each. (1) Standalone: the owner came directly to figure out their salary; after a successful accept, confirm the saved number and you're done. (2) As an onboarding step: an earlier get_company_onboarding_status next_step routed you here (its detail was reasonable_salary_calculator). In that case acceptance is NOT the end of onboarding — after a successful accept, call get_company_onboarding_status again. Acceptance advances the flow, so the refreshed next_step points to the real next step (typically continue_in_gusto with the URL to send the owner to). Never invent or hardcode that destination URL yourself; always take it from the refreshed onboarding status — and if it comes back as set_password instead, there is no URL to relay: follow that step's own message. Either way the accepted salary still has to reach payroll: when the flow later has you finalize the owner with manage_company_members, pass that figure as amount with payment_unit YEAR instead of asking them what to pay themselves. Skipping it leaves them on payroll at no salary.
calculate_payroll
ChatGPTInternal tool for payroll calculation. Use run_payroll instead.
calculate_rd_tax_credit
ChatGPTEstimates the annual federal R&D tax credit (IRC §41) a business could claim, from how many US people work on building or improving its product, what they're paid on average, and what the business does. Returns the estimated credit, the inputs it used, and guidance. A ballpark for comparison, NOT tax advice, and it files nothing. CALL IT BEFORE ASKING THE USER ANYTHING. Every argument is optional, so pass whatever they have already told you and call it empty only when they have told you nothing — calling empty and then again with numbers already in hand just costs a round trip. If they are signed in to Gusto the server already knows their business and may hand back a complete estimate with no questions at all — for a company that has run payroll that is Gusto's own modelled estimate from real payroll, better than anything these three inputs can produce. The company's own figures take precedence over values you pass, so a number the user guessed cannot improve the answer and asking for it wastes their time. It also needs no company, EIN, entity or payroll history at all, so a business that isn't a Gusto customer still gets an estimate from the three inputs below. ALWAYS FOLLOW guidance, returned on every response. It says how to present the number, what to ask for next, and whether an industry code would change anything. It is the authority when it differs from this description; paraphrase it rather than reading it out. When needs is non-empty, ask for everything it names in one message and call again. Never invent a headcount, a salary or an industry code: a guessed number becomes a number the user believes. Resolve an industry code with search_business_info (type industry) from the business's own words and let the user pick, but only when guidance asks for one. IT DOES NOT ANSWER WHETHER THEY QUALIFY. That turns on whether the work itself looks like research, which this tool never sees. A number here is what the credit could be worth if they qualify, never confirmation that they do, AND A LOW NUMBER IS NOT EVIDENCE THEY DON'T — it reflects only headcount and pay. Send "can we claim this?" to check_rd_credit_qualification. NOT THE SAME AS ITS NEIGHBOURS: calculate_scorp_tax_savings estimates savings from electing S-corp status, and calculate_reasonable_salary suggests an owner's W-2 salary. Neither has anything to do with the R&D credit. check_rd_credit_qualification answers whether the work qualifies at all. Use this tool for "how much".
calculate_reasonable_salary
ChatGPTCalculates an IRS-defensible reasonable salary for an S-corp owner from Bureau of Labor Statistics (BLS) wage data, given the company's ZIP code and one or more occupations. Returns the recommended annual salary, a defensible range, and the BLS wage area. Look up each occupation code with search_business_info (type occupation) first. GATHERING INPUTS — collect what this tool needs conversationally, one step at a time; don't ask for everything in one message and don't assume values. Follow this order: 1. Location first. Ask for the company's 5-digit ZIP code — it sets the BLS wage area. If the user offers only a city or state, ask them for the ZIP rather than guessing one yourself; a guessed ZIP can land on the wrong wage area. 2. Roles, one at a time. Ask what the owner does, then call search_business_info (type occupation) for that role, present the candidates, and let the user pick the code before asking about anything else — never guess BLS codes. Most owners have a single role; only gather more if the user says they wear more than one hat, resolving each role fully before starting the next. 3. Per-role details. For each chosen occupation confirm experience_level, plus — for a multi-role owner — the time_percentage split and which role is primary. Offer a sensible default and let the user adjust; don't apply these silently. 4. Optional refinements. Only if relevant, ask about a part-time work_schedule or an annual_net_revenue cap; otherwise leave them out. Confirm every input before calling. A failure returns a kind and a message; branch on kind, not on the message text. RECOVERABLE — fix the inputs per the message and re-call: no_occupations (the occupations array was empty — gather at least one role, per step 2), time_percentages_not_100, duplicate_occupation_code, multiple_primary_occupations, part_time_hours_required, incomplete_occupation (a role is missing an experience level or time percentage), invalid_occupation_code (re-run search_business_info), missing_area and zip_lookup_failed (re-confirm the business's 5-digit ZIP), and salary_data_unavailable (BLS publishes no wages for that role, even nationally — ask for a different role). Several of these are about one role rather than the whole request. For duplicate_occupation_code and incomplete_occupation the message names the role — fix only that one, and do not re-gather the others. For invalid_occupation_code and salary_data_unavailable the message does NOT say which role it was, so with more than one role you cannot tell from the response alone: re-check the codes you sent with search_business_info rather than guessing, and ask the user before dropping a role. TERMINAL — do NOT re-call with the same company; say what happened and stop: company_not_eligible (reasonable salary applies only to companies taxed as an S-corp, which no input change fixes) and no_draft_team_member (the owner's profile is not ready yet — tell the user to try again later rather than retrying in this conversation). Treat an unfamiliar kind as recoverable by reading its message, rather than failing the conversation. Make ONE call once the inputs are confirmed. When the owner fills more than one role (e.g. a founder who both writes software and runs the business as CEO), list every role in the occupations array with time_percentage values summing to 1.0 in that single call — do not fire separate calculate_reasonable_salary calls per role. The tool blends them into one composite salary; separate calls would each overwrite the last. This tool keeps ONE in-progress estimate per company/owner: every successful call overwrites that single estimate and there is no history, so do not issue parallel or speculative calls — to compare scenarios, run them one at a time and show each result before recalculating. The estimate is referenced implicitly by the authenticated company/owner, so this call intentionally returns no id; accept_reasonable_salary returns the persisted estimate's id. After a successful calculati…
check_plaid_connection_status
ChatGPTReports where the company's Plaid bank connection stands. Use this to confirm the outcome of a connect_bank_via_plaid link, since that flow finishes in an external browser window and reports back to Gusto out of band — nothing in this conversation observes it directly. WHEN TO USE: After the user says they have finished (or abandoned) a Plaid link, to find out what actually landed before telling them anything. Also safe to use to check whether a company already has a bank connection before offering the Plaid flow at all. WHEN NOT TO USE: Do not poll this repeatedly in a loop while waiting — the connection only appears once Plaid reports the finished session, so call it when the user says they are done. Do not use it to ask the user for bank account or routing numbers; it only reads existing state. RETURNS: This reports the company's most recent live bank connection, not a roll-up of every bank account it has — a company can hold an already-verified account while a newly connected one is still verifying, and this reports the new one. Always branch on status, not on success alone — success: true only means the check ran. connected: true with status: "connected" means the bank is verified and onboarding can move on. status: "pending_micro_deposits" means the bank is connected but verifying over 1-2 business days; nothing further is needed from the user, so do not re-offer the link. status: "not_connected" means nothing landed, so the user likely did not finish. status: "connection_unusable" means the latest attempt failed and needs a fresh link. When present, account_last_digits is the last few digits of the connected account, safe to read back to the user for confirmation. On error, { success: false, error_type, message }. PREREQUISITES: A valid access token whose company the acting user is a member of. VOICE: helpful, not technical. Don't show the user this tool's internal names — question keys, field names, tool names, status values — describe what they mean instead, and don't volunteer counts unless asked. Where a value has a proper name, use it: "the Plus plan", not "plus". Codes the user picks from a list, like NAICS or workers' comp class codes, are content: show those verbatim.
check_rd_credit_qualification
ChatGPTAssesses whether a business's work could qualify for the federal R&D tax credit (IRC §41): whether what they build looks like research, what stands in the way, and which tax year to pursue. Returns an assessment, what would sharpen it, and guidance. NOT tax advice, and it files nothing. NEVER TELL THE USER THEY DO NOT QUALIFY. This tool cannot return that answer and neither should you. Around half the businesses who walk away from this credit talk themselves out of it, usually because "we don't do research" — while running exactly the kind of work that counts. A weak result here means we have seen little, not that there is nothing there. That goes for every blocker too: each one carries a remedy, none of them is total, and none of them is a no. TIMING IS NEVER A REASON THEY CANNOT CLAIM EITHER — the year this names always has an open window, and the credit is claimable every year. CALL IT WITH NO ARGUMENTS FIRST, before asking the user anything. Every argument is optional. For a signed-in company the server often already knows the entity type, financial year end, claim year and whether they have filed, and hands back a filing window with no questions at all. ALWAYS FOLLOW guidance, returned on every response. It says how to present the result, which blockers to state as fact and which to raise as questions, what to ask next, and how much weight this assessment carries. It is the authority when it differs from this description; paraphrase it rather than reading it out. When needs is non-empty, ask for what it names — one thing at a time, in the user's own words, never as a tax question — and call again. Never guess an entity type or a tax year. NOT THE SAME AS calculate_rd_tax_credit, which estimates how much the credit could be worth. That one answers "how much could we get"; this one answers "can we claim it". Use both when the user wants both. calculate_scorp_tax_savings and calculate_reasonable_salary are about S-Corp election and owner pay, have nothing to do with the R&D credit, and are never a substitute for this tool.
connect_bank_via_plaid
ChatGPTOpens a Plaid-hosted flow where the user connects the company's payroll funding account — the account payroll and taxes are paid from — verifying instantly in most cases. This is the ONLY way to add a bank account during onboarding: the bank questions cannot be answered in chat, and save_company_onboarding_answer rejects them. Whatever the user enters in the Plaid flow goes straight to Plaid and Gusto — this tool does NOT collect bank account numbers, routing numbers, or banking credentials through the conversation, and you never see what was entered. NAMING: When you tell the user about this step, call it the company's payroll funding account. Do not shorten it to "your bank account". WHEN TO USE: Whenever next_step returns detail connect_bank, or the user asks to add or change the company's payroll funding account. There is no manual alternative to offer alongside it. WHEN NOT TO USE: Never ask the user to type a bank login, routing number, or account number into chat, and never offer to enter those on their behalf — not as an alternative to this tool, not if the user asks to, and not if they volunteer the numbers unprompted. Those are entered only in the Plaid flow. If the user will not use Plaid, send them to Gusto to add the account there. Do not call this again for the same company while a link from earlier in this conversation is still pending — wait for the user to say they've finished, then confirm with check_plaid_connection_status before offering it again. RETURNS: Branch on success. On success, { success: true, status: "plaid_connection_pending", url, message } — tell the user to open the link, connect the company's payroll funding account, and come back; do not ask them to report back what they saw or any account details. On error, { success: false, error_type, message }. PREREQUISITES: A valid access token whose company the acting user is a member of. VOICE: helpful, not technical. Don't show the user this tool's internal names — question keys, field names, tool names, status values — describe what they mean instead, and don't volunteer counts unless asked. Where a value has a proper name, use it: "the Plus plan", not "plus". Codes the user picks from a list, like NAICS or workers' comp class codes, are content: show those verbatim.
create_company
ChatGPTSIGNUP/ONBOARDING PHASE tool, and the first step — the other onboarding tools are company-scoped and fail until this has created a company. Create the user's Gusto company and payroll-admin account once the user has confirmed the details they want to sign up with. Use this tool for account creation; do not call a separate lead tool first (the lead is created server-side). The account email is already established — it is the address the user verified when they signed in. Do not ask the user for an email. Call create_company with the confirmed flag set to false first; the response returns account_email. Confirm that address and the company details with the user, then call again with the confirmed flag set to true. Company creation is not the final account step for chat signups. After onboarding setup is complete, Gusto sends a password setup email, and the user must open that email to finish securing the account and sign in to Gusto directly. Required fields, company_name, first_name, last_name, confirmed. Optional enrichment fields, number_employees, phone, states.
create_reports
ChatGPTEnqueues one or more reports. A single-payroll entry usually finishes in 10-60 seconds. A payroll_journal date-range entry can take up to an hour for a company with over 100 active employees, since it routes to a slower queue -- other date-range report types (e.g. contractor_payments_summary) run on a faster queue and don't have that delay. After calling this tool, call get_reports to check progress. There's no wait primitive here and no clock to pace a fixed cadence against, so check at most 5 times, a few seconds apart, then tell the user the report is still generating rather than looping indefinitely -- especially for a payroll_journal date-range entry, where a handful of quick checks won't be enough; don't mistake incomplete generation for failure. Use this tool, not get_payroll, whenever the user asks for a "payroll report", "payroll summary report", "payroll journal report", "payroll journal", or a CSV/exportable payroll document -- these all describe the same report_type: payroll_journal, not distinct or ambiguous intents. get_payroll only returns raw JSON line-item details for a single payroll; it does not produce a report file. Available report types: - payroll_journal: Payroll Journal Report (CSV). Either payroll_uuid for a single payroll (its company is looked up automatically, so company_uuid is not needed), or company_uuid plus a start_date/end_date date range (dates alone can't identify a company -- if you don't already know it, call get_token_info first: use resource.uuid for a single-company token, or pick one from accessible_resources for a multi-company token). Dates filter on paycheck date (the day employees are paid), not pay period -- list_payrolls defaults to pay-period dates, so pass date_filter_by=check_date and processing_statuses=processed there to match this report's basis. The date range cannot exceed 366 days. Use list_payrolls to find a payroll_uuid if unsure. - cash_requirements: Cash Requirements Report, summarizing the cash needed to fund a single payroll. Requires payroll_uuid (its company is looked up automatically). There is no date-range variant. - contractor_payments_summary: Contractor Payments Summary Report (CSV). Requires company_uuid plus a start_date/end_date date range (dates alone can't identify a company -- if you don't already know it, call get_token_info first). Dates filter on paycheck date. The date range cannot exceed 366 days. There is no single-payroll variant. Not every report type is available on every connection. Attempt the entry either way and react to the result: if it comes back with error_type restricted_report, this connection cannot create that report type and retrying will not help, so tell the user instead. Returns {reports: [...]}, one entry per input entry, in the same order. A successful entry is {company_uuid, report_request_uuid, status: 'pending', message}; a failed one is {company_uuid, success: false, error} with no report_request_uuid -- skip entries carrying success: false rather than assuming every entry has an id to poll.
get_company
ChatGPTRetrieves comprehensive business profile information including legal name, business entity type (LLC, Corporation, etc.), EIN, primary contact details, and configured locations. Use this to answer questions about company setup, business structure, or basic organizational info. VOICE: helpful, not technical. Don't show the user this tool's internal names — question keys, field names, tool names, status values — describe what they mean instead, and don't volunteer counts unless asked. Where a value has a proper name, use it: "the Plus plan", not "plus". Codes the user picks from a list, like NAICS or workers' comp class codes, are content: show those verbatim.
get_company_onboarding_package
ChatGPTSIGNUP/ONBOARDING PHASE tool. Requires an existing company — if the account does not have one yet, this reports company_exists false and next_step create_company; call create_company, then retry. Returns the company's available plans, add-ons, and benefits during onboarding, plus Gusto's recommended package and the company's current selection. Use this to present the options and the recommendation, compare tiers, or answer pricing questions — all from the returned payload. ONCE THE PROFILE IS READY FOR A RECOMMENDATION: when the only required question left in get_company_onboarding_status is the plan choice (tier_selection) — i.e. every other required question is answered — call this tool to present Gusto's recommendation: explain what's included and why it fits their profile, then ask whether they'd like to proceed with the recommended plan or explore other options before you save their tier_selection (via save_company_onboarding_answer). Do NOT wait for tier_selection itself to be answered before presenting the recommendation — the recommendation is what informs that choice. WHEN TO USE: When the user is choosing or asking about a Gusto plan during onboarding — to present available plans/add-ons, show the recommendation and why, compare tiers, or answer "how much does X cost". WHEN NOT TO USE: To read a single onboarding question — use get_onboarding_answer. DATA RETURNED (keys are camelCase): plans and addOns, each with key (the value to save as plan/add_ons; stableId is also present but may be null, so use key), name, description, and a pricing object (baseFee, perEmployeeFee, currency; a fee is null when not charged); benefits with key, name, and pricingNote (quoted with partner carriers at setup, not on the Gusto invoice); the recommended package (plan, addOns, benefits, and a rationale) and the company's current selected package; readyForPackageRecommendation (whether every required profile question EXCEPT the plan choice is answered — i.e. the recommendation is ready to present); and profileComplete (whether ALL required questions, including the plan choice, are answered). The recommended block is null until readyForPackageRecommendation is true and a recommendation has been computed. The recommendation is computed once and reflects the profile answers at that time; it is not recomputed here if answers change afterward. SIDE EFFECT: not a pure read — the first call made once the profile is ready computes and stores Gusto's recommendation (a one-time computation; later calls do not recompute it). Calling it before the profile is ready is a safe no-op for the recommendation (the recommended block stays null). PREREQUISITES: The recommendation populates once the company's required profile questions EXCEPT the plan choice are answered (see get_company_onboarding_status). VOICE: helpful, not technical. Don't show the user this tool's internal names — question keys, field names, tool names, status values — describe what they mean instead, and don't volunteer counts unless asked. Where a value has a proper name, use it: "the Plus plan", not "plus". Codes the user picks from a list, like NAICS or workers' comp class codes, are content: show those verbatim.
get_company_onboarding_status
ChatGPTSIGNUP/ONBOARDING PHASE tool. Requires an existing company — if the account does not have one yet, this reports company_exists false and next_step create_company; call create_company, then retry. Returns the onboarding status for a company's current experience. The current experience includes its questions — each with a key, a description, whether it has been answered, whether it is required, and a value_schema describing the fields its answer expects (field name, type, and allowed enum values). Use the value_schema to construct the value for save_company_onboarding_answer without guessing field names. Some answers are resolved with a helper tool rather than the value_schema alone: for industry_selection call search_business_info (type "industry"), present its candidates and let the user pick one rather than choosing for them — unless they name a code themselves, which already is their pick — and never guess NAICS/SIC codes. Separately, some large, well-known fields are free-text coded — their value_schema shows a string array with no enum list (e.g. states_employees_work_in, international_employees_countries). For these, collect the user's answer in natural language and map it to canonical codes yourself: US states as 2-letter uppercase codes including DC and PR (other US territories are not accepted), and countries as ISO 3166-1 alpha-2 (e.g. GB, IN, MX) — don't present the full list as options. A save with an invalid code returns the allowed values so you can correct it. Also returns total_questions and answered_questions counts (over every question listed here, required or not; questions withheld from this list are not counted). DRIVING ONBOARDING — work through the questions with the user and save each answer with save_company_onboarding_answer. Each question's required flag indicates whether it must be answered for onboarding to proceed. Required questions (required is true) are mandatory — collect an answer for every one, and do NOT offer the user the option to skip them. Only optional questions (required is false) may be skipped — surface them and offer to capture an answer, but make clear the user is free to skip them. Setup is complete once all required questions are answered — optional questions may stay unanswered, so do NOT treat answered_questions == total_questions as the bar. Bank details are withheld from this list entirely and are collected by connect_bank_via_plaid, so every listed question can be answered while the bank account is still outstanding — the counts cannot tell you that, and next_step is what surfaces it: detail connect_bank where the Plaid tool is available, otherwise a hand-off to Gusto to add the account there. Always follow next_step rather than inferring from this list that setup is done. When summarising what is left for the user, say the bank account still needs connecting unless next_step shows it is done — otherwise the summary omits a required step and the user has no way to know it is coming. IMPORTANT - the question list is dynamic; saved answers can re-route the flow (e.g. a solo owner gets different questions than an employer), so this list is stale after any save_company_onboarding_answer call. Re-plan from that call's returned onboarding_status, or re-call this tool. QUESTION ORDER — next_step.next_question_group is the set of question keys to ASK the user RIGHT NOW. They are all safe to ask this turn and independent of each other, so the order among them does not matter — ask them in whatever order and grouping reads most naturally. Use judgment on how to ask: rather than dumping all of them in one message — or asking strictly one at a time — ask them in a few logically-related, digestible chunks (a couple to a handful at a time, grouping related topics, e.g. the workforce questions — headcount and the states employees work in — together). Often it is just one key. This governs the ASK, not the save: save_company_onboarding_answer takes ONE question_key per call and there is no multi-answer save, so after the user replies, make a SEPARATE save_company_onboarding_answer c…
get_compensation
ChatGPTRetrieves full details for a single pay rate record by UUID, including rate amount, payment frequency, FLSA status, and effective date. Use list_job_compensations first to find the compensation UUID. Call this for specific details about one pay rate entry. To change a pay rate, use update_compensation.
get_contractor
ChatGPTRetrieves full profile for a single contractor by UUID, including name, email, business name (if applicable), payment method, and engagement dates. Use list_contractors first to find the contractor UUID. Call this for detailed info about a specific independent worker.
get_contractor_payment
ChatGPTRetrieves full details for a single contractor payment by UUID, including amount, payment method, bonus breakdown, and reimbursements. Use list_contractor_payments first to find the payment UUID. Call this for line-item details of one specific contractor payment.
get_contractor_payment_group
ChatGPTRetrieves all individual contractor payments within a batched payment group by UUID. Shows each contractor's payment amount and details from that batch. Use list_contractor_payment_groups first to find the group UUID. Call this to see all payments in a single batch run.
get_contractor_payment_groups
ChatGPTReturns batched contractor payment runs for the company. A payment group represents multiple contractor payments processed together on the same date. Omit contractor_payment_group_uuid to list groups with their UUIDs, check dates, and processing status, optionally within a start_date to end_date range. Pass contractor_payment_group_uuid to fetch a single group with each contractor's payment amount and details from that batch. Payments identify contractors by contractor_uuid only, so call get_contractors once without contractor_uuid to get their names.
get_contractor_payments
ChatGPTReturns payments made to independent contractors. To list payments, pass start_date and end_date, which shows payment amounts, check dates, and contractor info for that range. Use this read-only tool to see contractor payment history, audit 1099 payments, or find how much was paid. Pass contractor_payment_uuid instead to fetch one existing payment in full, including amount, payment method, bonus breakdown, and reimbursements. Use pay_contractors to create a new domestic contractor payment. Note - only includes payments to domestic (US) contractors. International contractor payments are not included.
get_contractors
ChatGPTReturns the company's independent contractors (1099 workers). Unlike employees (W-2), contractors are paid separately and file their own taxes. Omit contractor_uuid to list contractors with pagination and search, returning UUIDs, names, and basic info. Use this read-only tool to find contractor UUIDs or get a roster of non-employee workers; use pay_contractors to create a new domestic contractor payment. To look up several contractors at once, such as everyone in a payment group, list them in one call without contractor_uuid and match on UUID rather than fetching each one. The list includes inactive contractors, so check the is_active field for current status. Pass contractor_uuid to fetch one contractor's full profile, including name, email, business name (if applicable), payment method, and engagement dates. Note - this only includes domestic (US-based) contractors. International contractors are not included in results. If the company has international contractors, mention that totals reflect domestic contractors only.
get_department
ChatGPTRetrieves full details for a single department by UUID, including name, parent department (if nested), and list of assigned employees. Use list_departments first to find the department UUID. Call this for details about one specific department.
get_departments
ChatGPTReturns the company's departments with their UUIDs, titles, and the UUIDs of the employees and contractors assigned to each. Omit department_uuid to list every department, which is enough to see the org breakdown or department headcounts. Pass department_uuid to fetch a single department. Members are returned as UUIDs only, so use list_employees to resolve names. Note - department employee lists and headcounts only include domestic (US) employees. International employees are not reflected in these counts.
get_employee
ChatGPTRetrieves full profile for a single domestic (US-based) employee by UUID, including name, email, hire date, department, manager, job title, work location, current pay rate, time-off policy assignments, and time-off balances. Use list_employees first to find the employee UUID. Call this when you need detailed info about one specific person. International employee data is not available through this endpoint.
get_employee_earnings_summary
ChatGPTReturns per-employee earning breakdowns (commissions, bonuses, tips, etc.) aggregated across all processed payrolls in a date range. Use this when the user asks about specific earning types attributed to individual employees, such as "How much has each employee been paid in commissions this year?" or "Who received bonuses last quarter?" Default date range is year-to-date. This tool provides per-employee attribution that list_payrolls cannot - list_payrolls only has payroll-wide totals. IMPORTANT - Never guess which employees received specific earning types from aggregate totals. Always use this tool for per-employee earning attribution. Note - only includes earnings for domestic (US) employees. International employee earnings are not included.
get_employee_home_address
ChatGPTRetrieves full details for a single home address record by UUID, including street, city, state, ZIP code, and effective dates. Use list_employee_home_addresses first to find the address UUID. Call this for complete address details for one specific record.
get_employee_home_addresses
ChatGPTReturns an employee's residential addresses, which are used for tax withholding calculations and mailing. Pass employee_uuid to list every home address on file for that employee, including current and historical addresses with street, city, state, ZIP code, and effective dates. Pass home_address_uuid instead to fetch a single address record.
get_employee_rehire
ChatGPTRetrieves information about an employee being brought back to the company after a previous departure. Includes the new start date and any updated employment terms. Use this to check if someone is a returning worker and when they rejoined.
get_employee_work_address
ChatGPTRetrieves full details for a single work location assignment by UUID, including the location address and effective dates. Use list_employee_work_addresses first to find the work address UUID. Call this for complete details about a specific work location assignment.
get_employee_work_addresses
ChatGPTReturns the work locations assigned to an employee. Work addresses determine work-state tax jurisdiction. Pass employee_uuid to list every work location assignment for that employee, including current and historical assignments with the location address and effective dates. Use this to see where someone works or has worked, especially for remote or multi-location workers. Pass work_address_uuid instead to fetch a single assignment.
get_job
ChatGPTRetrieves full details for a single job position by UUID, including title, department, location, FLSA classification, and current pay rate. Use list_employee_jobs first to find the job UUID. Call this for detailed info about a specific role assignment.
get_location
ChatGPTRetrieves full details for a single company location by UUID, including complete address, phone number, and filing addresses for tax purposes. Use list_locations first to find the location UUID. Call this for complete information about a specific office or work site.
get_locations
ChatGPTReturns the physical office or work locations registered for the company. Locations are used for tax filing, work address assignments, and compliance. Omit location_uuid to list every location with its address, UUID, and whether it is active. Pass location_uuid to fetch one location in full, including phone number and filing addresses for tax purposes.
get_onboarding_answer
ChatGPTRequires an existing company — if the account does not have one yet, call create_company first, otherwise this fails. Returns the current answer for a single onboarding question, identified by its question_key. Every one of the question's fields is returned — a null field value means that field has not been set. Use this to read the current state of a specific question before deciding whether to update it, or to verify a previous save took effect. WHEN TO USE: When you need the current value of one specific onboarding question. WHEN NOT TO USE: To discover available question_keys or check overall onboarding progress — use get_company_onboarding_status instead. DATA RETURNED: An answer hash containing every one of the question's fields; a null field value means that field has not been answered yet. An unknown question_key returns an error rather than an empty answer. PREREQUISITES: Call get_company_onboarding_status first to discover valid question_keys before calling this tool. VOICE: helpful, not technical. Don't show the user this tool's internal names — question keys, field names, tool names, status values — describe what they mean instead, and don't volunteer counts unless asked. Where a value has a proper name, use it: "the Plus plan", not "plus". Codes the user picks from a list, like NAICS or workers' comp class codes, are content: show those verbatim.
get_pay_schedule
ChatGPTRetrieves full details for a single pay schedule by UUID, including frequency, anchor dates, and next scheduled pay dates. Use list_pay_schedules first to find the schedule UUID. Call this to see when the next payday is or understand schedule configuration.
get_pay_schedules
ChatGPTReturns the company's configured pay schedules. Omit pay_schedule_uuid to list every schedule with its frequency (weekly, biweekly, monthly, etc.), name, and UUID. Pass pay_schedule_uuid to fetch one schedule in full, including anchor dates and next scheduled pay dates, which answers when the next payday is. Does not show which workers are on each schedule; use list_pay_schedule_assignments for that.
get_payroll
ChatGPTRetrieves complete details for a single payroll by UUID, including worker earnings, taxes, deductions, and net pay. This tool is read-only; use update_payroll to modify payroll inputs (hours, memos, bonuses, PTO) or run_payroll to calculate and submit the payroll. Entries in employee_compensations may carry a benefits breakdown, with company contribution and employee deduction as separate amounts. Benefits require the employee_benefits:read permission and are not returned for every caller, so treat their absence as a permission or configuration difference rather than as the employee having no benefits. Payroll-wide benefit totals in totals are always returned. Benefit lines cover only the employees on the requested page, so they sum to totals only when the payroll fits on one page.
get_reports
ChatGPTChecks the status of one or more previously triggered reports. On success, returns the CSV content inline (as csv_content, truncated with csv_truncated: true beyond 500 KB -- when truncated, do not compute totals or other aggregates from csv_content, since rows past the cut are missing). Call this after create_reports to check progress -- check at most 5 times, a few seconds apart, then tell the user the report is still generating rather than looping indefinitely; a date-range report can take up to an hour for a large company, so a handful of quick checks won't always be enough. csv_content is per-employee wage and tax data. Summarize or answer from it rather than pasting the raw CSV into the conversation. A report_request_uuid is only readable by the same token that created it -- a different admin's token, or the same admin's token used later without that context, gets a failed status with an error_reason saying so. Do not retry; the report exists, but that token cannot read it. A connection restricted from sensitive data can only read contractor payments summaries, custom reports whose columns pass the restriction check, and (for no-PII connections) cash requirements. Any other report fails with a restricted error. Do not retry. Pass report_request_uuids (from create_reports output) as a flat list -- each report's company is looked up automatically, so no company info is needed here. Returns {results: [...]}, one entry per report_request_uuid, in the same order. One report failing does not abort the others.
get_smb_jobs_report
ChatGPTReturns the Gusto Small Business Jobs Report: monthly net hires (new hires minus terminations) for US small businesses with 1-49 employees. The figures are nationally representative: a stratified random sample of about 100,000 of Gusto's 500,000+ customers, weighted to the national mix of industry, size, region (BLS QCEW) and company age (Census BDS), and seasonally adjusted via the US Census Bureau's X-13ARIMA-SEATS methodology. Covers January 2019 through the most recently completed month, nationally or broken down by industry, US Census region, or company-size band. WHEN TO USE: - Questions about US small-business hiring, labor-market conditions, or job growth/contraction, overall or for a specific industry, region, or company-size band. - "Which industry/region/size band hired the most?" — omit category to get every category ranked within each month. - Comparing hiring trends across industries/regions/size bands or over a specific date range. - "Is that slower hiring or more layoffs?" — read hires and terminations alongside the net figure. - Market context for a specific business's own hiring decision ("is now a good time to hire?") — use it alongside that business's own headcount and payroll records, not in place of them. WHEN NOT TO USE: - Questions about wages, pay growth, or hourly earnings — use get_smb_pay_metrics instead. - A specific business's own hires, terminations, headcount or pay — this is aggregate data for US small businesses as a whole, not any one company's payroll. DATA RETURNED: - series: monthly net hires for the national series or one category, each month also carrying hires and terminations — the two sides of the net figure, so a move can be attributed to hiring or to separations. Ranked categories carry them too. Covers the last 24 months unless you pass startMonth; monthsCovered tells you how much more there is. - rankings: returned instead of series when category is omitted — every category ranked within each month. With no startMonth/endMonth you get the LATEST MONTH ONLY; pass a range for more. - rank inside rankings is by net hires, 1 = most added. Net hires is a flow, so the biggest job LOSS is the highest rank number — skip suppressed categories, which have no value. For "which changed most", compare yoyChange across categories instead of re-reading rank. - latest: the last month of the requested window with its month-over-month and year-over-year change (single-category and national only). That is the newest month unless an endMonth ends the window earlier; read provisional before calling it current. - monthsCovered: the full extent of the dataset. A startMonth/endMonth window entirely outside it, or an endMonth before startMonth, is an error that names the covered range. - methodology: a one-line description of the sample and adjustment method. INTERPRETATION: - Net hires is a FLOW, not an employment level. A value of 20,000 means US small businesses added 20,000 more jobs than they lost that month. It is not an employment level, so never describe it as "total jobs." Summing months gives the net change over the period, not a headcount. - Because it crosses zero, changes are reported in absolute jobs, never as percentages. - hires and terminations are published independently of the net figure, all three as rounded weighted estimates, so subtracting them lands within one job of value rather than exactly on it. Quote value for net hires instead of recomputing it, and don't present the gap as a discrepancy. One cell is further out: companySize band "1" at 2026-01, where the adjusted sides imply 6,677 against a published 6,242. - Round net hires when quoting them, matching the published report: to the nearest thousand at 10,000 and above, the nearest hundred from 1,000 to 9,999, and the nearest ten below that. 27,878 is "about 28,000", never "27,878" — these are weighted estimates and the digits imply precision they do not have. - latest.trailing12MonthAverage is the standard comparison for a single month, and is what the …
get_smb_pay_metrics
ChatGPTReturns Gusto's SMB Pay Metrics: monthly average hourly earnings or new-hire pay (in USD) for US small businesses with 1-49 employees. The figures are nationally representative: a stratified random sample of about 100,000 of Gusto's 500,000+ customers, weighted to the national mix of industry, size, region (BLS QCEW) and company age (Census BDS), and seasonally adjusted via the US Census Bureau's X-13ARIMA-SEATS methodology. Covers January 2019 — new-hire pay starts February 2019 — through the most recent month; read monthsCovered for the exact extent. Available nationally or broken down by industry, US Census region, or company-size band. WHEN TO USE: - Questions about US small-business wages, pay growth, hourly earnings, or starting/new-hire pay, overall or for a specific industry, region, or company-size band. - "Which industry/region/size band pays the most?" — omit category and read rank. - "Where are wages growing fastest?" — omit category and compare yoyPercentChange across categories. rank is by pay level and will answer this wrongly. - Comparing pay trends across industries/regions/size bands, or between new-hire pay and overall average pay. - Benchmarking a specific business's own pay decisions (raises, offers, whether it pays competitively) — use it alongside that business's own pay records, not in place of them: the answer needs both. WHEN NOT TO USE: - Questions about hiring volume, net hires, or the number of jobs added/lost — use get_smb_jobs_report instead. - A specific business's own hires, terminations, headcount or pay — this is aggregate data for US small businesses as a whole, not any one company's payroll. DATA RETURNED: - series: monthly hourly pay in USD for the national series or one category. Covers the last 24 months unless you pass startMonth; monthsCovered tells you how much more there is. A series that published nothing in that default window comes back in full instead, so an all-suppressed result means the series is genuinely empty and not merely stale. - rankings: returned instead of series when category is omitted — every category ranked within each month. With no startMonth/endMonth you get the LATEST MONTH ONLY; pass a range for more. - rank inside rankings is by pay level, 1 = highest paid — it says nothing about direction. For "grew or fell most", compare yoyPercentChange across categories: its lowest (most negative) value is the biggest decline. The lowest-paid category is not the one that fell most. Suppressed categories have no value and no rank. - latest: the last month of the requested window with its month-over-month and year-over-year change, in both USD and percent (single-category and national only). That is the newest month unless an endMonth ends the window earlier; read provisional before calling it current. - monthsCovered: the full extent of the dataset. A startMonth/endMonth window entirely outside it, or an endMonth before startMonth, is an error that names the covered range. - methodology: a one-line description of the sample and adjustment method. INTERPRETATION: - This is an hourly rate, not annual salary or total payroll. - Some industry/month cells are suppressed: value is null and suppressed is true. That is missing data, not zero pay — don't average over it or read it as a decline, and don't describe a suppressed category as low-paying. New-hire pay by industry is the only affected series: Management (55) has no published value in any month, Mining (21) publishes in only some months, and 61, 71 and 11 each have a few gaps. Read suppressed per month rather than assuming a whole industry is missing. Utilities (22) is different again — it is not carried in this series at all, and requesting it is an error rather than a suppressed series. - Where a series has gaps, the most recent published month may be well in the past. Say which month a figure is from rather than presenting an old value as current. - New-hire pay is a 3-month rolling average. Describe its changes as trends, not single-month moves. - Ave…
get_tasks
ChatGPTRequires a company in context. Lists the authenticated user's outstanding tasks (to-dos) across Gusto - payroll blockers, time-off requests, compliance items, document signatures, and more, in one flat list. Each task includes a title, message, category, optional due date, and an optional deep link (a ready-to-use absolute URL) for tasks with no matching tool. Priority is one of "high", "medium", or "low"; "high" tasks are payroll blockers. Returns an empty list when there are no outstanding tasks, rather than an error. Returns at most 100 tasks; if more exist, the response includes truncated: true. Use this to answer "what needs my attention in Gusto?" Attempt to resolve each task with a tool you already have; when none applies, hand the task off to the caller via its deep link instead of claiming it was resolved.
get_time_off_balances
ChatGPTReturns employees' current time-off balances - available (balance), accrued, used, and pending hours per policy - with each balance attributed to the worker (name) and policy uuid. Policy name and type are included only when the token also holds the time_off_policies:read scope; without it, policy labels come back blank (the policy uuid is still returned). Use this when an admin asks about PTO, sick, or vacation balances (e.g. "how much vacation does each employee have left?"). Optionally scope with employee_uuids or policy_uuids (comma-separated). Note - covers domestic (US) employees; balances reflect the company's configured time-off policies.
get_time_off_requests
ChatGPTReturns a company's time-off requests (PTO, sick, vacation, etc.). Omit time_off_request_uuid to list requests. With no filters that returns all of them. Filter by status (comma-separated - pending, approved, declined, consumed), start_date/end_date (YYYY-MM-DD, matched against the request's dates), and employee_uuids (comma-separated) to scope to specific workers. Pass time_off_request_uuid to fetch a single request. Each request includes the worker (name + uuid), status, policy (type + uuid), the per-day hours requested, and the initiator/approver. Employee and employer notes are omitted, since they are free text that may contain health information. Time off may be managed natively in Gusto or by a third-party integration; this returns the company's requests either way. Note - covers domestic (US) workers.
get_time_sheet
ChatGPTRetrieves detailed time entries for a single timesheet by UUID, including daily hours worked, overtime, breaks, and notes. Third-party time tracking only - there is no native equivalent, and passing a native shift id fails with a transport-level "resource not found" whose text talks about credentials and configuration rather than the real cause. Check that list_time_records reported a third_party source first, and take the timesheet's top-level id from there. For native companies list_time_records already returns per-shift detail, so no follow-up call is needed. Call this for a line-item breakdown of someone's hours for a specific pay period.
get_token_info
ChatGPTReturns information about the current API access token including which permissions (scopes) are granted and which company resources can be accessed. Use this to check what data operations are available or troubleshoot access issues before attempting other API calls.
list_contractor_payment_groups
ChatGPTLists batched contractor payment runs for the company. A payment group represents multiple contractor payments processed together on the same date. Shows group UUID, check date, and processing status. Use this to see batched payment history or find payment group UUIDs.
list_contractor_payments
ChatGPTLists all payments made to independent contractors within a date range. Shows payment amounts, check dates, and contractor info. Requires start_date and end_date parameters. Use this to see contractor payment history, audit 1099 payments, or find how much was paid to contractors.
list_contractors
ChatGPTLists all independent contractors (1099 workers) for the company with pagination and search. Returns contractor UUIDs, names, and basic info. Unlike employees (W-2), contractors are paid separately and file their own taxes. Use this to find contractor UUIDs or get a roster of non-employee workers.
list_custom_fields_schema
ChatGPTRetrieves the definitions of all custom fields configured for the company, including field names, data types, and selection options. Custom fields let companies track additional worker attributes beyond standard HR data. Use this to understand what custom data is available before querying individual worker field values.
list_departments
ChatGPTLists all departments in the company org structure, including department names, UUIDs, and which employees are assigned to each. Use this to see the organizational breakdown, find department headcounts, or understand how workers are grouped.
list_earning_types
ChatGPTLists all earning type categories configured for the company, such as regular pay, overtime, bonuses, commissions, tips, and custom earning types. Shows type name, category, and whether it's taxable. Use this to understand available pay types for payroll input.
list_employee_custom_fields
ChatGPTRetrieves all custom field values set for a specific employee. Custom fields are company-defined attributes like T-shirt size, emergency contact, certifications, or any other custom data. Use list_custom_fields_schema first to see available field definitions.
list_employee_employment_history
ChatGPTRetrieves the complete work history timeline for an employee, including all positions held, role changes, and status transitions. Use this to answer questions about someone's tenure, past roles, or employment dates within the organization.
list_employee_home_addresses
ChatGPTLists all residential addresses on file for an employee, including current and historical addresses with effective dates. Home addresses are used for tax withholding calculations and mailing.
list_employee_jobs
ChatGPTLists all job positions held by an employee, including current and past roles. Each job record contains title, location, hire date, and rate information. Use this to see someone's role history or find job UUIDs needed for compensation lookups.
list_employee_terminations
ChatGPTRetrieves offboarding and separation records for an employee, including departure dates, reasons for leaving, and final pay information. Use this to find when someone left the company, their exit date, or details about their offboarding process.
list_employee_work_addresses
ChatGPTLists all work locations assigned to an employee, including current and historical assignments with effective dates. Work addresses determine work-state tax jurisdiction. Use this to see where someone works or has worked, especially for remote or multi-location workers.
list_employees
ChatGPTLists all employees for the company with pagination and filtering options. Returns basic profile data for each person. Filter by onboarding status, active/inactive status, or search by name. Use this to find employee UUIDs, get headcount, or answer questions about the workforce roster. Without filters, returns all employees including terminated; use terminated=false for active employees only. Note - this only includes domestic (US-based) employees. International employees are not included in results or headcount. If the company has international employees, mention that totals reflect domestic employees only.
list_job_compensations
ChatGPTLists the pay rate history for a job position, showing all salary or hourly rate changes over time. Each entry includes effective date, rate amount, and payment unit (hourly/salary). Use this to see pay history or track when raises were given. By default only the current compensation is returned. Set include to all_compensations to retrieve the full history. To change a pay rate, use update_compensation.
list_locations
ChatGPTLists all physical office or work locations registered for the company, including addresses and whether each is active. Locations are used for tax filing, work address assignments, and compliance. Use this to see all company offices or find location UUIDs.
list_pay_periods
ChatGPTLists all pay periods (date ranges when work is performed) for the company, with links to associated payroll runs. Shows start date, end date, check date, and payroll status. Use this to see upcoming pay periods or find which payroll covers a specific date range.
list_pay_schedule_assignments
ChatGPTShows which employees are assigned to which pay schedules. Returns mappings between worker UUIDs and schedule UUIDs. Assignment rules vary by company setup - some assign by department, others individually. Use this to find out when a specific person gets paid or which schedule they follow.
list_pay_schedules
ChatGPTLists all configured pay schedules for the company, showing frequency (weekly, biweekly, monthly, etc.), name, and schedule UUID. Does not show which workers are on each schedule. Use this to understand pay frequency options or find schedule UUIDs for assignment lookups.
list_payroll_blockers
ChatGPTIdentifies issues preventing a specific payroll from being processed, such as missing bank accounts, incomplete tax setup, or unsigned documents. Each blocker includes a description and resolution steps. Use this to diagnose why payroll cannot run or to check readiness before processing.
list_payrolls
ChatGPTLists all payroll runs for the company with filtering options. When called with no arguments, returns all payrolls (processed and unprocessed, regular, off_cycle, and external) from the past 6 months (start_date defaults to 6 months ago, end_date defaults to today). You can filter results by providing processing_statuses, payroll_types, start_date, end_date, or include parameters. Date filters apply to pay period (work dates), not payment dates. Date range constraints are that the range cannot exceed 1 year, and end_date cannot be more than 3 months in the future. Returns payroll UUIDs, check dates, processing status (processed,unprocessed), and type (regular,off_cycle,external). Use include=totals to get payroll-wide aggregate amounts (gross pay, taxes, net pay, total commissions, total bonuses). These totals are NOT broken down per employee. For per-employee earning breakdowns (who received which commissions, bonuses, etc.), use get_employee_earnings_summary instead. IMPORTANT - Never guess or infer which employees received specific earning types from aggregate totals alone. Common use case is to find the next payroll to process by filtering for processing_statuses=unprocessed and selecting the payroll with check_date closest to today's date. Note - payroll data only covers domestic (US) employees. International employee payroll is managed separately and not included here. Payroll sub-state within unprocessed: each list item carries processed (boolean) and calculated_at (nullable timestamp), but the roster (employee_compensations) is NOT included in list responses. From this list alone, use calculated_at to distinguish sub-states within processing_statuses=unprocessed: - pre-prepare candidate: calculated_at: null. - calculated: calculated_at is a timestamp. When the user asks for "unprepared", "draft", or "not-yet-prepared" payrolls, filter by processing_statuses=unprocessed and pick items with calculated_at: null. Then call get_payroll on the chosen item to confirm the roster is unmaterialized (employees: [], employee_compensations empty or absent) before invoking update_payroll — that combined signal is what makes the pre-prepare materialize path safe.
list_time_records
ChatGPTRequires an existing company — if the account does not have one yet, call create_company first, otherwise this fails. Lists time records for the company over a pay period. The response is discriminated by source: - source: 'native' returns shifts (clock-in/out events, breaks, durations) plus workers, everyone who tracks time at the company, for companies on Gusto's native time tracking. workers covers employees and contractors alike, and lists a worker even when they have no shifts in the requested period, so use it to find the companyMemberUuid for someone you want to record a first shift for. - source: 'third_party' returns timesheets for companies with an active third-party time tracking integration, each carrying shiftStartedAt, shiftEndedAt and timezone so you can tell which day it covers. The tool eagerly paginates the third-party feed internally, so callers receive every timesheet in one response. - source: 'none' returns neither array; the company has not completed native onboarding and has no active third-party integration. For companies that have both native onboarding and third-party time tracking active, only the third-party data is returned, mirroring what those customers see in product. Always check source before reading shape-specific fields. Every shift and timesheet also carries the worker's identity: firstName, lastName, preferredName, workerType (employee, contractor, or international_contractor), and the worker's public id - employeeUuid for employees or contractorUuid for contractors (the other is null). Use these to label records and to join back to employee/contractor tools. Identity fields are null when a member can't be resolved. On native time tracking, a contractor's clockInTimestamp and clockOutTimestamp are only readable when the time was entered or edited by an admin; for time the contractor clocked themselves both come back null, because Gusto withholds a contractor's raw clock times from everyone but the contractor. date and durationInMinutes are always populated, so report contractor hours from those rather than treating a null timestamp as a missing shift. Employee timestamps are unaffected.
list_time_sheets
ChatGPTLists all timesheets for hourly workers across the company. Each timesheet represents one person's hours for a pay period. Shows total hours, approval status, and associated payroll. Use this to review pending time entries, find unapproved timesheets, or audit hours worked.
manage_account
ChatGPTPerforms account-level actions on the signed-in Gusto account. Set action to choose what to do; only the actions listed below are supported, so do not invent others. action "get_status" — reports whether this account has set a Gusto password and can sign in on the website. Onboarding tools already withhold their gusto.com url until a password is set, so you need this only when the user says they set one, asks why they cannot sign in, or when a chat-signup account reaches next_step complete — that covers the company's setup, not website access, so mention any unset password alongside the good news. action "resend_password_setup_email" — re-sends the email that lets the user set a Gusto password and finish converting their signup into a full account. Use this only when the user says they did not get that email, deleted it, or the link expired. The email is sent automatically when signup setup completes, so there is no need to call this as a normal step. Sending is rate limited, so a repeat call inside a few minutes reports that the most recent email is still valid rather than sending another — relay that to the user instead of retrying. A successful response means the email was sent, NOT that the account is already upgraded: the user still has to open it and choose a password.
manage_business_insurance_application
ChatGPTStarts or updates a business insurance application, which could be to submit a lead, get a quote, or bind a policy, with Gusto Insurance Agency, a licensed insurance agency. Today this sends the request to a licensed agent who follows up; it does not return quotes or bind policies. Returns the application's id and status, plus needs, next_steps, disclosure and guidance. Works for businesses that don't use Gusto. Call it only after the user asks for coverage or asks to be contacted about it. Pass only what the user has told you; never guess or invent a value. If you already have every detail, pass them all in the first call. Never infer business.state from a city name alone: a city can be in more than one state. If the user gives only a city or region, leave state out of the call and ask which state before sending it. Send the state when the user names or confirms it, or when it follows from a ZIP code in the business's own address. A contact's phone number says nothing about where the business operates, so never use an area code to fill in the state. When needs is non-empty, ask the user for everything it names in one message, then call again with the same application_id. Don't present the application as submitted until status says so. If the response includes suggested_contact_email, that is the email on file for the user's Gusto account. Propose it as the contact email and ask the user to confirm it or give another. Never use it without their confirmation. ALWAYS FOLLOW guidance: it says what happens next for this application and how to present it. ALWAYS show disclosure verbatim. NEVER state or estimate prices, name carriers, or recommend coverage unless this tool returns them. Not for policies the user already has, claims, certificates of insurance, or general questions about what coverage a business needs. For WA or WY workers' comp class code lookups, use search_workers_comp_class.
manage_company_members
ChatGPTAdds or changes ONE company member (employee or contractor) per call — the name is plural for the resource, not for batching. A single call can do the whole job: create the member, set whichever of their basics, compensation, employment and work-address you pass fields for, and with submit: true finalize them into a real team member. Two ways to call it: - New worker: omit draft_company_member_id and set worker_type. Pass everything you already know, including submit: true when you have their legal name, and this one call finishes the job. - Existing draft: pass the draft_company_member_id this tool returned plus the fields to change. Use this to fix anything that came back wrong, and to finalize later with submit: true. Finalizing: pass submit: true only once you have the worker's LEGAL name from the user. If you have just a display or preferred name, leave submit off, confirm the legal name, then call again with the returned draft_company_member_id and submit: true. Never guess a legal name. For a business contractor set person_type BUSINESS before finalizing. Finalizing is one-way on this connection: once a team member is finalized, no tool here can change them — corrections are made in Gusto. So do not offer to fix a finalized team member; tell the user what to change in Gusto instead. Fields by section — only the sections you pass fields for are touched: - basics: legal_first_name + legal_last_name (provide together), legal_middle_name, email, preferred_first_name, business_name, worker_type, person_type, works_from_home. - compensation: compensation_type, amount (+ optional currency_code, defaults USD), payment_unit, receives_commission_payments, add_to_time_tracking, state_managed_wc_covered + state_managed_wc_state (+ optional state_managed_wc_class_code). - employment: start_date, work_state, country_code, flsa_status, employment_status, two_percent_shareholder. - work_address: work_address_id (the id of an existing company location from get_locations — this does not create one). To add a location, answer company_work_address with save_company_onboarding_answer, then re-read get_locations for the new id. The new address becomes a work location either way; physical_business_address is a separate, single designation, so pass it false unless the user wants this address to become the company's physical business address — passing true moves that designation off whichever address holds it now. PO boxes are rejected for either flag. Use works_from_home only for genuinely remote workers, never in place of a location not yet added: it records no address until the worker finishes self-onboarding (their home address then becomes their work address), so state tax setup stays locked until then, and telling the user it is covered is wrong. Required before a worker can be finalized — a submit fails until each of these is set: - Everyone: worker_type, legal_first_name + legal_last_name, country_code, start_date, and — unless no invite is being sent (send_invite false, or an omitted flag on a draft-id finalize) — email, since the self-onboarding invite is sent there. - Employees: flsa_status, employment_status, payment_unit, amount, and a work location: ask the user for the address where they work — not their home address — and pass its work_address_id, since that work address is what unlocks state tax setup. works_from_home plus work_state is only for an employee the user says is remote. - Employees working in WA or WY: also state_managed_wc_covered + state_managed_wc_state, because those states run their own workers' comp fund, plus state_managed_wc_class_code when covered (the user may have it; otherwise look it up with search_workers_comp_class). - Contractors: person_type, compensation_type, amount, and business_name for a BUSINESS contractor. - Unpaid members: nothing beyond the shared fields — they have no compensation. Per-member: no bulk. For several workers, call this once per worker. Before finalizing a worker, tell the user what the invite does and let them choose: the worker gets an email with a secure link and ente…
open_secure_session
ChatGPTOpens a secure Gusto panel on screen where the user completes a sensitive action themselves. Supported purposes: signing a company form (e.g. a tax authorization), setting the acting admin up as the company signatory (which requires their SSN), and collecting a Social Security number or ITIN — either the Solo owner's, for their own onboarding profile, or the IRS Form SS-4 responsible party's, for the company's EIN request. Whatever the user enters in the panel is submitted straight to Gusto — this tool does NOT collect or accept a signature, legal name, SSN, bank details, or any other personal detail through the conversation, and you never see what was entered. WHEN TO USE: During onboarding when the company has a sensitive action to complete — a form awaiting signature, the admin needing to become the company signatory, the Solo owner's Social Security number still outstanding on their profile, or the EIN request missing the responsible party's personal tax ID — and the user wants to do it. Call this tool once with the matching purpose, and for ssn_collection the matching subject; the panel then handles the rest, including showing the user which items are outstanding and confirming each one. WHEN NOT TO USE: Do not ask the user to type their signature, legal name, SSN, or bank details into chat — those are entered only in the panel. RETURNS: Branch on success. On success, { success: true, status: "secure_session_ready", message } — confirm to the user that the panel is open and invite them to complete it there. On error, { success: false, error_type, message }. The panel resolves what is outstanding when it loads, and tells the user directly when there is nothing left to do. AFTER THE PANEL OPENS: Opening the panel does not complete the action, and neither does the user saying they are done — only their actually completing it does. Never tell the user the action is complete on the strength of their word alone. When they say they have finished, confirm it actually completed if you have a way to check before you tell them it is done; if it is still pending, say so plainly and offer to reopen the panel. PREREQUISITES: A valid access token whose company the acting user is a member of. GOTCHAS: The panel's session expires after a short while. If the user says it expired, call this tool again to open a fresh one. VOICE: helpful, not technical. Don't show the user this tool's internal names — question keys, field names, tool names, status values — describe what they mean instead, and don't volunteer counts unless asked. Where a value has a proper name, use it: "the Plus plan", not "plus". Codes the user picks from a list, like NAICS or workers' comp class codes, are content: show those verbatim.
record_time
ChatGPTRecords admin-entered time for a worker over a pay period. Routes automatically to the company's native time tracking or their connected external time-tracking partner - the caller never chooses the destination. Always preview existing hours with list_time_records and get explicit admin approval before calling this tool. On success the response carries status, source, id, and resulting_hours, and sometimes warning. resulting_hours is only populated for third-party writes; it is always null on the native path, so confirm native hours by re-reading with list_time_records rather than from the write response. id is the value to pass back as shift_id when updating the same record, but it is null whenever Gusto can't tell which shift it just wrote. That covers a native contractor, whose clock times are withheld, on any day that ends up holding more than one of their shifts, and any worker whose recorded clock-in doesn't match the one Gusto echoes back. The write still succeeded; get the shift's id from list_time_records before updating it. A warning means the write landed but something the caller asked for did not - relay it to the admin instead of reporting a clean success. One case where re-reading is not proof: a contractor who has no Gusto account of their own comes back from list_time_records with null start and end times even though the hours recorded, because Gusto withholds a contractor's clock times from admins unless it can confirm who last edited them. Do not re-record hours that came back successful, and do not tell the admin the write failed - a second write books the hours twice.
run_payroll
ChatGPTCalculates and submits an existing unprocessed payroll for W-2 employees. Use pay_contractors for domestic contractor payments. CANNOT create new payrolls or off-cycle payrolls. To modify payroll inputs (hours, amounts, earnings, memos, PTO) before running, use update_payroll. If the user needs an off-cycle payroll (bonus, correction, termination), they must first create it in Gusto, then return here to run it. When multiple unprocessed payrolls exist, prefer the one with a check date closest to today.
save_company_onboarding_answer
ChatGPTSIGNUP/ONBOARDING PHASE tool. Requires an existing company — if the account does not have one yet, call create_company first, otherwise this fails. Saves a single onboarding answer for the company. A saved answer can RE-ROUTE the onboarding flow — e.g. answering who_to_pay as a solo owner changes which questions remain — so any previously fetched question list is stale after a save. A successful response includes onboarding_status: the refreshed post-save status in the same shape as get_company_onboarding_status. Always re-derive the remaining questions from it (or re-call get_company_onboarding_status) instead of continuing through an earlier list. The re-routing is yours to handle, not the user's to hear about: do not tell them the question set or its count changed, and just ask the next question. Report a count only if they ask for one. If the answer is invalid, the response errors list names the expected fields and allowed values — retry with corrections. Don't invent question_keys; use the get_company_onboarding_status tool to discover valid keys and which remain unanswered. For question_key tier_selection (plan selection), first call get_company_onboarding_package — its plans/addOns keys are the valid plan and add_ons values, and it includes Gusto's recommendation to present to the user. Present that recommendation and confirm the user's choice before saving tier_selection. For question_key industry_selection, first call search_business_info with type "industry" and the business's own words — its results carry the verified naics_code to save. Present those candidates and confirm which one the user picks before saving: the pick is theirs, not yours, so do not settle on the top-ranked result yourself, and a document or profile that names the business's industry is not a pick — it describes the business, it does not choose between codes. A code or classification the user names themselves is the exception: that already IS their pick, so save it without asking them to choose again. Never guess NAICS/SIC codes; only save a code returned by that tool. The industry_selection answer also carries is_crb, a cannabis-related-business flag that steers package eligibility (a cannabis business cannot be offered 401(k)), so it must be set, not left blank. Ask the user a standalone yes/no question — near-verbatim: "To make sure we show you the right package options, is your business in the cannabis industry?" — and include is_crb (true or false) in the same industry_selection answer you save. Ask it plainly on its own; do not fold it into the industry-description question, and never set is_crb true without the user's explicit yes — do not infer it from the industry, NAICS code, or business name. For question_key tax_payer_type, only "LLC" and "C-Corporation" can elect S-corp taxation. When the user picks one of those, ask a separate follow-up — whether the business is taxed as an S corp (an elective status that passes profits through to the owner's personal return, avoiding double taxation) — and include taxable_as_scorp with their answer; do NOT assume false. For any other classification you don't need to ask about or send taxable_as_scorp; the system sets it. Bank accounts ARE connected here, with connect_bank_via_plaid: give the user the url it returns and confirm the outcome with check_plaid_connection_status rather than assuming it worked. Never tell the user the bank step has to happen in the Gusto web app while that tool is available. What cannot happen here is typing the details into chat: company_bank_account and plaid_bank_account are rejected if sent and are not listed as questions, so never ask for an account number, routing number, or bank login, and never offer to enter them on the user's behalf — even if they volunteer them or insist. Only if connect_bank_via_plaid is unavailable, send them to Gusto instead. The response also includes next_step, a structured cue for what to do next — follow it: answer_questions means the key(s) in next_question_group are all safe to ask this turn…
search_business_info
ChatGPTResolves a free-text description into verified, codified business-information candidates the user can choose from. Set type to pick what you're resolving; query is the user's free-text description in their own words. type "industry" — resolve what the business does into NAICS industry candidates, each with a verified 6-digit naics_code, name, and description. Use this whenever you need to set the industry_selection answer: pass the business's own words (e.g. "we run an apple orchard"), then save the naics_code the user picks with save_company_onboarding_answer. Candidates come back ranked by relevance, but ranking is a hint, not a decision — list them with their names and descriptions, ask which one fits, and wait for the answer before saving. Do not pick the top result on the user's behalf, and do not treat a document or profile that names the industry as the pick: near-identical candidates differ in how the business is treated downstream, so only the user can say which describes them. The exception is the user naming a code or classification themselves — that IS their pick, already made: check it appears in the results, then save it straight away rather than listing the candidates or asking them to choose again. Never guess NAICS codes; only save codes returned here. type "occupation" — resolve a job/role description into Bureau of Labor Statistics (BLS) occupation candidates, each with a code, name, and description (e.g. the code a reasonable- salary estimate needs). Pass the user's role in their words (e.g. "software developer" or "restaurant line cook"), present the options, and use the chosen candidate's code. Never guess BLS codes; only use codes returned here. For either type, if the list comes back empty, ask the user for a clearer description and search again. VOICE: helpful, not technical. Don't show the user this tool's internal names — question keys, field names, tool names, status values — describe what they mean instead, and don't volunteer counts unless asked. Where a value has a proper name, use it: "the Plus plan", not "plus". Codes the user picks from a list, like NAICS or workers' comp class codes, are content: show those verbatim.
search_workers_comp_class
ChatGPTResolves a description of the work someone does into that state's workers' comp risk-class candidates, each with a verified code and description. Requires state (WA or WY — only those two run their own state fund, so only they use class codes). Use this to get the state_managed_wc_class_code that manage_company_members needs to finalize a covered employee there: search the work the employee does (e.g. "roofing", "office administration"), present the candidates, and pass the code the user picks. Never guess a class code — it is validated against the state's list and a wrong one is rejected. Query with the WORK AS A NOUN, never a job title and never what the person does. These lists name trades, so "software" works where "work with computers" and "write code" do not, "plumbing" where "plumber" and "fixing pipes" may not, and "barber shop" where "hair stylist" does not. Verb and activity phrasing is the most common reason this search comes back wrong, because words like "work" appear in dozens of unrelated trades. If the user describes an activity, name the industry it belongs to and search that. If nothing comes back, rephrase in the state's industry terms and search again; two or three attempts is reasonable. If the user gives you a code themselves, that is their choice — pass it straight to manage_company_members as-is and do not run it through this search to second-guess it. Use this search only to resolve a code the user does not have. If a second wording also finds nothing in WA, call again with list_categories: true instead of guessing further. That returns the headings WA files its codes under — the list may simply not use your word for the work ("hair stylist" appears nowhere; the heading is "Beauty parlors"). Pick the heading that best covers the work, search again using it as the query, and present the codes it returns. WY has no such headings, so there rely on the search and on company_industry_candidates. If you still cannot find a code, stop and say so. Do not guess one, and do not set state_managed_wc_covered to false to get past the error — that tells Gusto the employee is not covered by the state fund, which is a false compliance answer and worse than leaving the work unfinished. Leaving the worker unfinalized is the correct outcome here: say you could not identify the class code and ask the user to set it in Gusto, where the picker lists the codes their company has configured. The code describes THE WORK THIS PERSON DOES, not what the business does. Two people at the same company routinely need different codes, and picking the company's trade for someone who doesn't do it overcharges the employer. In WY, office and sales staff have their own codes regardless of the industry — 000010 Clerical Office Occupations, 000020 Outside Sales, 000030 Inside Sales, 000040 Temporary Help - Office, 000050 Temporary Help - Other — so a bookkeeper at a roofing company is 000010, not a roofing code. Search for the person's actual work first; only reach for the company's trade when they really do that trade. For WY the results may also include company_industry_candidates: the codes matching the company's own registered industry. Those are the right answer only for someone doing that trade, and there is often more than one (roofing splits into all-types, residential and nonresidential), so present them and let the user choose rather than assuming the first. If the list comes back empty, ask the user for a clearer description and search again. VOICE: helpful, not technical. Don't show the user this tool's internal names — question keys, field names, tool names, status values — describe what they mean instead, and don't volunteer counts unless asked. Where a value has a proper name, use it: "the Plus plan", not "plus". Codes the user picks from a list, like NAICS or workers' comp class codes, are content: show those verbatim.
submit_feedback
ChatGPTSubmits feedback about this Gusto AI integration to the team that builds it. The message is sent to the Gusto team; this does not change any account data. SCOPE: only feedback about the AI integration itself belongs here - a tool that is missing or broken; a tool whose data disagrees with what the Gusto app shows for the same thing; a capability the user expected to reach through chat but cannot; a confusing or inaccurate tool description; the assistant misreading a request or formatting a reply badly; the connector itself failing, e.g. dropping the Gusto sign-in or losing authorization mid-session. OUT OF SCOPE: feedback about what Gusto does, where chat is merely how the user happens to be talking to you - accounting-sync behavior (e.g. QuickBooks), billing and subscription terms, benefits, or a Gusto policy the user dislikes. "Expose X through the tools" is in scope; "change what Gusto does" is not. A number the user disputes is out of scope when they disagree with how Gusto calculated it, and in scope when the tool reports something different from the app. WHEN TO USE: When the user vents, suggests an improvement, reports a bug, or praises something about this integration while working in chat. Offer it after a notable action (e.g. running payroll) when the user reacts to how the assistant handled it. If you cannot tell whether the feedback is about this integration or about Gusto itself, ask one clarifying question rather than guessing; if it is still unclear after that, submit it - a misrouted note costs less than a lost one. When one message mixes in-scope and out-of-scope feedback that you can already tell apart, do not ask - submit the in-scope part and tell the user why the rest is not going through. WHEN NOT TO USE: For clearly out-of-scope feedback - do not call this tool. Tell the user plainly that this reaches only the team building the Gusto AI integration, so their feedback would not reach the team that owns it, and point them to https://support.gusto.com - name that URL rather than telling them to look in the Gusto app, since they may be in ChatGPT or Claude rather than in Gusto. Never reword out-of-scope feedback to sound in-scope. Also not for support that needs a synchronous answer, or for account problems only a human can fix on the user's own account - this is one-way product feedback, not a support ticket. RETURNS: Branch on success. On success, { success: true, status: "received", feedback_id: "<uuid>" } - received means the feedback was accepted and queued for the Gusto team (delivery is asynchronous, so this confirms acceptance, not that the team has seen it yet); surface the feedback_id so the user can reference it. On invalid input, { success: false, error_type: "validation_error", message: "<reason>" }. If the feedback can't be queued, { success: false, error_type: "delivery_error", message: "<reason>", feedback_id: "<uuid>" } - the submission was not accepted; ask the user to retry. PREREQUISITES: A valid access token. No company context required. GOTCHAS: One-way product feedback, not a support ticket - there's no in-channel reply. message is capped at 5000 characters.
submit_payroll
ChatGPTInternal tool for payroll submission. Use run_payroll instead.
update_compensation
ChatGPTUpdates an employee's compensation - the pay rate, pay period, or FLSA status for one of their jobs. Use this for a raise, a pay cut, or to correct a rate that was entered wrong. REQUIRED WORKFLOW: Call list_job_compensations (or get_compensation) FIRST for the job you intend to change. Show the user the current rate and effective date, get explicit approval for the exact proposed change, then invoke this tool with the target compensation_uuid, the version from that read, and the new values. APPEND vs OVERWRITE is decided by effective_date, compared against the CURRENT compensation's effective_date (not today), not by you: - An effective_date AFTER the current compensation's effective_date records a NEW dated compensation that takes effect on that date; current pay is unchanged until then. This is the normal path for a raise or any scheduled change. If the current compensation has minimum-wage adjustment enabled, a scheduled change is refused (it cannot carry that setting forward) - tell the user to make it in Gusto. - Omitting effective_date (or passing the current compensation's own effective_date) CORRECTS the current compensation in place, with no new dated row. Use this only to fix a rate that was entered wrong and has NOT yet been paid. If a payroll covering that period has already been calculated but not submitted, the in-place correction is refused (it would not update that draft) - schedule the change with a future effective_date, or make the correction in Gusto so the payroll picks up the new rate. - An effective_date BEFORE the current compensation's effective_date is rejected with a recoverable error: you cannot move a compensation earlier onto an already-run payroll. Use a Correction off-cycle payroll for an amount that was already paid. Correcting a compensation in place affects pay going forward and does not retroactively change an already-run payroll, which stays as it was paid. To change an amount that was already paid, run a Correction off-cycle payroll in Gusto. CANNOT create a new job or delete a compensation. To stop paying someone or remove a compensation, tell the user to do it in Gusto (for example by terminating them or ending the job); never set the rate to 0, or a near-zero amount, as a substitute: a $0 rate means pay calculated at that compensation is $0 from its effective date. CANNOT rename a job title on its own: a title change with no pay change is a job update and is out of scope, so tell the user to rename the title in Gusto. A title supplied ALONGSIDE a pay change is applied at the change's effective date. VALUE SEMANTICS: values REPLACE existing values, they do not add. rate: "85000.00" sets the rate to 85000; it is not a delta. Omitted fields are left unchanged. If the user's intent is relative ("bump her 5%"), compute the new absolute rate yourself from the current value and send that, showing the user "70000.00 -> 73500.00" before invoking the tool. Constraints and edge cases: - rate is a string; follow the input_schema types and do not do arithmetic on returned string amounts without parsing. - payment_unit is the pay basis (Hour, Week, Month, Year, Paycheck). Switching an employee between hourly and salaried has downstream effects on how they are paid; confirm the switch with the user before sending it. - effective_date is YYYY-MM-DD. - version is required: pass the version from your most recent read of this compensation (get_compensation, list_job_compensations, or a prior update_compensation response). If the compensation changed since then, the tool returns a recoverable stale-version error and writes nothing: re-read it, show the user the current values, and get their approval again before retrying. Recompute any relative change from the new values. - A successful response may include a warnings array describing real side effects of the change (for example: converting a worker to hourly can turn off AutoPilot for their whole pay schedule; an owner's rate is stored as a converted per-paycheck amount, so the stored number differs from what you sent). Relay every warning to the…
update_payroll
ChatGPTUpdates an existing UNPROCESSED payroll with new hours, earnings, PTO, memos, payment methods, or off-cycle settings. Use this to correct or finalize payroll inputs before running the payroll. REQUIRED WORKFLOW: Call get_payroll FIRST for any payroll you intend to update. If get_payroll returns a populated employee_compensations array, show the user the current values, get approval for the exact proposed change, then invoke this tool with the touched employees and deltas. If get_payroll returns no materialized roster (employee_compensations is empty or absent, employees is [], and calculated_at is null), the payroll is in a pre-prepare state (its roster has not been materialized yet). In that case, invoke this tool with an empty employee_compensations array. The tool will materialize the roster and return it; you can then read the populated employee_uuids from the response and invoke this tool again with your specific deltas. CANNOT create new or off-cycle payrolls. CANNOT run or submit payroll (use run_payroll). CANNOT edit processed or submitted payrolls — this tool returns a recoverable error and no change is made. CANNOT restructure the payroll (only values of existing fields). VALUE SEMANTICS: values REPLACE existing values, they do NOT add. Sending hours: "5" sets total hours to 5, not +5. Omitted employees, compensations, and PTO entries are LEFT UNTOUCHED — this is a partial update, not a full replace. If the user's intent is additive or subtractive ("add 5 hours", "give her 2 more hours of PTO", "cut his overtime in half"), compute the new total yourself using the current value from get_payroll's response, then send the computed total — never send the delta. Example: user says "add 5 hours to Bob" and Bob's current Regular Hours from get_payroll is 40; send hours: "45", not hours: "5". Show the user "40 → 45" before invoking the tool. KEYING (how a submitted entry matches an existing one): - fixed_compensations and hourly_compensations: keyed by name (immutable identifier — must match an existing entry from get_payroll's response; do not invent names). - paid_time_off: keyed by name OR policy_uuid (supply exactly one, not both). Per-employee updatable fields: excluded (skip employee for this payroll), payment_method ("Direct Deposit" or "Check"), memo (paystub note), fixed_compensations, hourly_compensations, paid_time_off. Deductions and reimbursements cannot be edited here. Removing an employee from a payroll: set excluded: true on their entry. The employee stays on the roster but is not paid on this run. Send excluded: false to re-include. Use this whenever the user asks to "remove", "skip", "drop", or "take off" an employee for a specific payroll run. Off-cycle-only top-level fields: withholding_pay_period, skip_regular_deductions, fixed_withholding_rate. These apply to GENERAL off-cycle payrolls only (Correction, Bonus, Adhoc). Termination and transition off-cycles reject them. Use get_payroll first to check the payroll's off_cycle_reason before sending these fields. Constraints and edge cases: - Setting payment_method to "Direct Deposit" is rejected if the employee has no bank account on file. - Response currency fields (amount, hours) are returned as strings. Do not do arithmetic on them without parsing. - Follow the input_schema types for each field: amount/hours fields are strings. - Blockers: the response may include a blockers array when the caller has payrolls:run scope. Do NOT preemptively surface these to the user during the update turn. Complete the requested update and describe what changed. Blockers will surface naturally when the user attempts to run the payroll (run_payroll); that is the correct moment to discuss them. - Hourly editability by FLSA status: hourly_compensations are editable only for employees whose flsa_status is Nonexempt, Salaried Nonexempt, or Commission Only Nonexempt. Attempts to edit hours on any other status (Exempt, Commission Only Exempt, Owner, Unknown) are rejected with a validation_error, since hour edits on those statuses corrupt the …
accept_reasonable_salary
Claudecalculate_payroll
Claudecalculate_rd_tax_credit
Claudecalculate_reasonable_salary
Claudecheck_plaid_connection_status
Claudecheck_rd_credit_qualification
Claudeconnect_bank_via_plaid
Claudecreate_company
Claudecreate_reports
Claudeget_company
Claudeget_company_onboarding_package
Claudeget_company_onboarding_status
Claudeget_compensation
Claudeget_contractor
Claudeget_contractor_payment
Claudeget_contractor_payment_group
Claudeget_department
Claudeget_departments
Claudeget_employee
Claudeget_employee_earnings_summary
Claudeget_employee_home_address
Claudeget_employee_rehire
Claudeget_employee_work_address
Claudeget_home_address
Claudeget_job
Claudeget_location
Claudeget_onboarding_answer
Claudeget_pay_schedule
Claudeget_payroll
Claudeget_rehire
Claudeget_reports
Claudeget_time_off_balances
Claudeget_time_off_request
Claudeget_time_sheet
Claudeget_token_info
Claudeget_work_address
Claudelist_contractor_payment_groups
Claudelist_contractor_payments
Claudelist_contractors
Claudelist_custom_fields
Claudelist_custom_fields_schema
Claudelist_departments
Claudelist_earning_types
Claudelist_employee_custom_fields
Claudelist_employee_employment_history
Claudelist_employee_employments
Claudelist_employee_home_addresses
Claudelist_employee_jobs
Claudelist_employee_separations
Claudelist_employee_terminations
Claudelist_employee_work_addresses
Claudelist_employees
Claudelist_job_compensations
Claudelist_locations
Claudelist_pay_periods
Claudelist_pay_schedule_assignments
Claudelist_pay_schedules
Claudelist_payroll_blockers
Claudelist_payrolls
Claudelist_time_off_requests
Claudelist_time_records
Claudelist_time_sheets
Claudemanage_account
Claudemanage_company_members
Claudeopen_secure_session
Claudepay_contractors
Claudequery_faq
Clauderecord_time
Claudereview_contractor_payment
Clauderun_payroll
Claudesave_company_onboarding_answer
Claudesearch_business_info
Claudesearch_workers_comp_class
Claudesubmit_feedback
Claudesubmit_payroll
Claudeupdate_payroll
Claude