Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gusto-preview.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Use this table to see all the current notification types with a brief description on what the messaging will include, the contents of its resource array, what triggers it, whether it is actionable or not, whether it is payroll blocking, and whether it expires.
CategoryTitleMessageResource entity typesTriggerActionableAction ItemPayroll BlockingResolves?Expires?Template Variables
state_tax.ga_w4_filingFile %{employee_name}‘s G-4The G-4 lets us withhold the correct amount of state income tax for %{employee_name}. Please mail a copy of their completed and signed Form G-4 to the Georgia Department of Revenue.entity_type: “Employee”Employee in GA sets withholding allowance to over 14, or employee is marked as exempt from GA state income taxyesMail Form G-4 for employeenoyesno{employee_name}
state_tax.mi_w4_filingFile %{employee_name}‘s MI-W4The MI-W4 lets us withhold the correct amount of state income tax for %{employee_name}. Please mail a copy of their completed and signed Form MI-W4 to the Michigan Department of Treasury.entity_type: “Employee”Employee in MI sets personal and dependent allowance to over 10, or employee is marked as exempt from MI state income taxyesMail Form MI-W4 for employeenoyesno{employee_name}
state_tax.wa_lni_proactive_rcc_correctionUpdate %{employee_name}‘s risk class codeTheir risk class code looks incorrect. We need this info to file and pay their taxes—update it as soon as possible. \n \nVisit the WA L&I website to find the codes assigned to %{company_name}. To clarify which employees should be assigned to each code, please call the agency at (360) 902-4817.entity_type: “Employee”Invalid WA risk code, risk class codes have not been assigned to company by the Washington Department of Labor and Industries (L&I)yesVisit the WA L&I website to find the codes assigned to your company. If you aren’t sure which of your employees should be assigned to each code, please call the agency at (360) 902-4817. Assign employees to correct risk class code.noyes - will get resolved after 14 days and account_suspension.pending notification will be sentno{employee_name}, {company_name}
state_tax.al_sui_poaSend a notarized Power of Attorney form for AlabamaTo authorize us to take payroll-related actions on behalf of %{company_name} must submit a notarized Power of Attorney form in Alabama. This lets us pay and file unemployment taxes.noneIf company is liable for State Unemployment Tax Act (SUTA) in Alabama and PoA form has not been submitted yetyesSend PoA form for Alabamanoyesno{company_name}
state_tax.ma_withholding_tpaGrant access to the Massachusetts Department of Revenue accountTo authorize us to take payroll-related actions on behalf of %{company_name}, grant us access to Massachusetts Department of Revenue account. This lets us monitor Massachusetts tax account info for changes, to help avoid notices, penalties, and interest.noneWhen setting up state of Massachusetts and no access to accountyesGive access to accountnoyesno{company_name}
state_tax.ga_stateFinish Georgia registration%{company_name} needs to complete Georgia tax setup. We need one last detail before we can file tax returns.noneDid not finish filling out Georgia tax setup infoyesFinish filling out Georgia tax setup infonoyesno{company_name}
state_tax.ma_ui_registrationGrant access to the Massachusetts Department of Unemployment Assistance accountTo authorize us to take payroll-related actions on behalf of %{company_name}, grant us access to Massachusetts Department of Unemployment Assistance account. We can’t pay or file taxes without this access. \n \nPlease reach out to our support team for instructions and help.noneWhen setting up state of Massachusetts and no access to accountyesGive access to accountnoyesno{company_name}
state_tax.reopen_suspended_tax_agency_accountReopen %{state} tax accounts and confirm the detailsContact the agency to reopen tax accounts. Then let us know by confirming the details of each account. If the details are incorrect and our payments are unsuccessful, penalties and interest may apply.noneWhen reopening a new state for taxes either through a new hire or an employee address change, need to reopen state accountsyesContact state tax agencies to reopen your company tax account, then confirm the details to make sure nothing has changednoyesno{state}
state_tax.ar_stateFinish Arkansas withholding registrationFinish Arkansas withholding registration. We need one last detail about Arkansas withholding before we can file tax returns.noneCustomer provides the Account ID (EIN). \nFirst payroll gets run. \nCompany gets unsuspendedyesProvide us the last payment amount with the agencynoyesnoNone
state_tax.co_city_tax_owners_fieldTell us about business owners and officers in ColoradoSome cities in Colorado require employers to pay occupational privilege taxes (OPT) for business owners and officers who are not included on payroll‚ tell us if this is applicable.noneCustomer has applicable taxes in Denver, Greenwood or GlendaleyesCustomer needs to suggest if they are liable for occupational privilege taxesnoyesnoNone
state_tax.colorado_department_of_labor_and_employment_third_party_authorizationGrant Gusto access to the Colorado Department of Labor and Employment accountGrant Gusto access to the Colorado Department of Labor and Employment account. We can’t pay or file taxes without this access.noneCompany becomes eligible for unemployment taxes. \nCompany runs their first payroll. \nCustomer provides the Account ID (EIN)yesCustomer needs to confirm that they have provided Gusto a TPA accessnoyesnoNone
state_tax.colorado_paid_family_and_medical_leave_third_party_authorizationGrant access to the Colorado Family and Medical Leave Insurance accountGrant Gusto access to the Colorado Family and Medical Leave Insurance account. We can’t pay or file taxes without this access.noneApplicable as long as customer has an active account with an agencyyesCustomer needs to confirm that they have provided Gusto a TPA accessnoyesnoNone
state_tax.hi_ui_registrationFinish Hawaii unemployment registrationFinish Hawaii unemployment registration so we can pay and file quarterly returns.noneCustomer becomes eligible for unemployment taxes in HI.yesCustomer needs to complete their registration in HInoyesnoNone
state_tax.id_complete_id_withholding_regFinish Idaho withholding registrationCreate a Taxpayer Access Point (TAP) account and register with the Idaho State Tax Commission. This lets us pay and file income tax.noneApplicable by default as long as customer has a presence in stateyesCreate a Taxpayer Access Point (TAP) account and register with the Idaho State Tax Commission.noyesnoNone
state_tax.mn_revenue_registrationFinish Minnesota withholding registrationAuthorize Gusto with the Minnesota Department of Revenue, so we can pay and file taxes.noneGusto requests authorization once Account Number gets providedyesCustomer needs to authorize Gusto with Minnesota Department of RevenuenoyesnoNone
state_tax.mn_revenue_registration_errorFinish Minnesota registrationWe couldn’t register ourselves with the Minnesota Department of Revenue, which means we can’t pay or file taxes. It’s okay‚ this should be a quick fix.noneGusto fails to request access to act on Customer’s behalfyesCustomer needs to fix issues with their registration with the tax agencynoyesnoNone
state_tax.mn_ui_registrationFinish Minnesota unemployment registrationFinish Minnesota unemployment registration so we can pay and file quarterly returns.noneCustomer becomes liable for unemployment taxesyesCustomer needs to register with the tax agencynoyesnoNone
state_tax.ms_needs_dor_letter_idFinish Mississippi withholding registrationWe need the Mississippi Department of Revenue Letter ID to complete your Mississippi withholding registration and file tax returns.noneEIN (account number) gets provided by the customer or we retrieve it via agency.yesCustomer needs to provide a letter IDnoyesnoNone
state_tax.nm_complete_withholding_regFinish New Mexico withholding registrationCreate a Taxpayer Access Point (TAP) account and register with the New Mexico Taxation & Revenue Department. This lets us pay and file withholding taxes.noneAn EIN gets provided by the customer or we retrieve it via agencyyesA customer needs to register themselves with the agency.noyesnoNone
state_tax.nm_workers_comp_coverageIndicate coverage under the New Mexico Workers’ Compensation ActIndicate coverage under the New Mexico Workers’ Compensation Act so we know whether or not to pay the Workers’ Compensation Fee.noneApplicable by default as long as company has a presence in the stateyesA customer needs to answer the question whether they eligible for workers comp coveragenoyesnoNone
state_tax.ok_tap_grantFinish Oklahoma withholding registrationAuthorize Gusto with the Oklahoma Tax Commission (OTC). This lets us pay and file withholding taxes.noneApplicable by default as long as customer has a presence in state.yesCustomer needs to confirm that they have provided Gusto with Oklahoma Tax CommissionnoyesnoNone
state_tax.ok_tap_registrationFinish Oklahoma withholding registrationCreate an OkTAP passphrase and register with the Oklahoma Tax Commission (OTC). This lets us pay and file withholding taxes.noneCustomer confirms that they have provided us the OkTAP Approval accessyesProvide a TAP passphrasenoyesnoNone
state_tax.pa_sui_enrollmentAuthorize Gusto for Pennsylvania Department of Labor & Industry accountAuthorize Gusto for Pennsylvania Department of Labor & Industry account. Authorization lets us pay and file unemployment taxes, keep tax info up-to-date, and reduce the likelihood of a tax notice.noneCompany becomes eligible for unemployment taxes.yesCustomer needs to confirm that they have provided Gusto a TPA accessnoyesnoNone
state_tax.pa_withholding_tpaGrant access to the Pennsylvania Department of Revenue accountGrant Gusto access to the Pennsylvania Department of Revenue account. This lets us monitor Pennsylvania tax account info for changes, to help avoid notices, penalties, and interest.noneGusto has requested a TPA access from customer.yesCustomer needs to confirm that they have provided Gusto a TPA accessnoyesnoNone
state_tax.pa_withholding_tpa_shared_secretEnter Pennsylvania Department of Revenue account Letter IDEnter Pennsylvania Department of Revenue account Letter ID. This is the first step to let us monitor Pennsylvania tax account info for changes, to help avoid notices, penalties, and interest.noneApplicable by default as long as customer has a presence in state.yesCustomer needs to provide a shared secret to Gusto. i.e. Letter ID, etcnoyesnoNone
state_tax.tx_ui_registrationGrant access to the Texas Workforce Commission accountGrant Gusto access to the Texas Workforce Commission account. This lets us monitor Texas tax account info for changes, to help avoid notices, penalties, and interest.noneCompany becomes eligible for unemployment taxes. \nGusto submits an authorization request.yesCustomer needs to confirm that they have provided Gusto a TPA accessnoyesnoNone
state_tax.va_sui_authorizationGrant access to the Virginia Employment Commission accountGrant Gusto access to the Virginia Employment Commission account. This lets us monitor Virginia tax account info for changes, to help avoid notices, penalties, and interest.noneCompany becomes eligible for unemployment taxes. \nCompany runs their first payroll. \nCustomer provides the Account ID (EIN). “yesCustomer needs to confirm that they have provided Gusto a TPA accessnoyesnoNone
state_tax.vt_submit_notarized_poaSend a notarized Power of Attorney form for VermontSend a notarized Power of Attorney form for Vermont. This lets us pay and file unemployment taxes.noneCompany becomes eligible for unemployment taxes. \nA PoA form gets generated.”yesSign a POA formnoyesnoNone
state_tax.wa_lni_poaGrant Gusto access to the Washington Labor & Industries account. We can’t pay or file taxes without this access.Grant Gusto access to the Washington Labor & Industries account. We can’t pay or file taxes without this access.noneA PoA form gets generatedyesSign a POA formnoyesnoNone