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.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.
| Category | Title | Message | Resource entity types | Trigger | Actionable | Action Item | Payroll Blocking | Resolves? | Expires? | Template Variables |
|---|---|---|---|---|---|---|---|---|---|---|
| state_tax.ga_w4_filing | File %{employee_name}‘s G-4 | The 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 tax | yes | Mail Form G-4 for employee | no | yes | no | {employee_name} |
| state_tax.mi_w4_filing | File %{employee_name}‘s MI-W4 | The 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 tax | yes | Mail Form MI-W4 for employee | no | yes | no | {employee_name} |
| state_tax.wa_lni_proactive_rcc_correction | Update %{employee_name}‘s risk class code | Their 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) | yes | Visit 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. | no | yes - will get resolved after 14 days and account_suspension.pending notification will be sent | no | {employee_name}, {company_name} |
| state_tax.al_sui_poa | Send a notarized Power of Attorney form for Alabama | To 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. | none | If company is liable for State Unemployment Tax Act (SUTA) in Alabama and PoA form has not been submitted yet | yes | Send PoA form for Alabama | no | yes | no | {company_name} |
| state_tax.ma_withholding_tpa | Grant access to the Massachusetts Department of Revenue account | To 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. | none | When setting up state of Massachusetts and no access to account | yes | Give access to account | no | yes | no | {company_name} |
| state_tax.ga_state | Finish Georgia registration | %{company_name} needs to complete Georgia tax setup. We need one last detail before we can file tax returns. | none | Did not finish filling out Georgia tax setup info | yes | Finish filling out Georgia tax setup info | no | yes | no | {company_name} |
| state_tax.ma_ui_registration | Grant access to the Massachusetts Department of Unemployment Assistance account | To 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. | none | When setting up state of Massachusetts and no access to account | yes | Give access to account | no | yes | no | {company_name} |
| state_tax.reopen_suspended_tax_agency_account | Reopen %{state} tax accounts and confirm the details | Contact 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. | none | When reopening a new state for taxes either through a new hire or an employee address change, need to reopen state accounts | yes | Contact state tax agencies to reopen your company tax account, then confirm the details to make sure nothing has changed | no | yes | no | {state} |
| state_tax.ar_state | Finish Arkansas withholding registration | Finish Arkansas withholding registration. We need one last detail about Arkansas withholding before we can file tax returns. | none | Customer provides the Account ID (EIN). \nFirst payroll gets run. \nCompany gets unsuspended | yes | Provide us the last payment amount with the agency | no | yes | no | None |
| state_tax.co_city_tax_owners_field | Tell us about business owners and officers in Colorado | Some 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. | none | Customer has applicable taxes in Denver, Greenwood or Glendale | yes | Customer needs to suggest if they are liable for occupational privilege taxes | no | yes | no | None |
| state_tax.colorado_department_of_labor_and_employment_third_party_authorization | Grant Gusto access to the Colorado Department of Labor and Employment account | Grant Gusto access to the Colorado Department of Labor and Employment account. We can’t pay or file taxes without this access. | none | Company becomes eligible for unemployment taxes. \nCompany runs their first payroll. \nCustomer provides the Account ID (EIN) | yes | Customer needs to confirm that they have provided Gusto a TPA access | no | yes | no | None |
| state_tax.colorado_paid_family_and_medical_leave_third_party_authorization | Grant access to the Colorado Family and Medical Leave Insurance account | Grant Gusto access to the Colorado Family and Medical Leave Insurance account. We can’t pay or file taxes without this access. | none | Applicable as long as customer has an active account with an agency | yes | Customer needs to confirm that they have provided Gusto a TPA access | no | yes | no | None |
| state_tax.hi_ui_registration | Finish Hawaii unemployment registration | Finish Hawaii unemployment registration so we can pay and file quarterly returns. | none | Customer becomes eligible for unemployment taxes in HI. | yes | Customer needs to complete their registration in HI | no | yes | no | None |
| state_tax.id_complete_id_withholding_reg | Finish Idaho withholding registration | Create a Taxpayer Access Point (TAP) account and register with the Idaho State Tax Commission. This lets us pay and file income tax. | none | Applicable by default as long as customer has a presence in state | yes | Create a Taxpayer Access Point (TAP) account and register with the Idaho State Tax Commission. | no | yes | no | None |
| state_tax.mn_revenue_registration | Finish Minnesota withholding registration | Authorize Gusto with the Minnesota Department of Revenue, so we can pay and file taxes. | none | Gusto requests authorization once Account Number gets provided | yes | Customer needs to authorize Gusto with Minnesota Department of Revenue | no | yes | no | None |
| state_tax.mn_revenue_registration_error | Finish Minnesota registration | We 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. | none | Gusto fails to request access to act on Customer’s behalf | yes | Customer needs to fix issues with their registration with the tax agency | no | yes | no | None |
| state_tax.mn_ui_registration | Finish Minnesota unemployment registration | Finish Minnesota unemployment registration so we can pay and file quarterly returns. | none | Customer becomes liable for unemployment taxes | yes | Customer needs to register with the tax agency | no | yes | no | None |
| state_tax.ms_needs_dor_letter_id | Finish Mississippi withholding registration | We need the Mississippi Department of Revenue Letter ID to complete your Mississippi withholding registration and file tax returns. | none | EIN (account number) gets provided by the customer or we retrieve it via agency. | yes | Customer needs to provide a letter ID | no | yes | no | None |
| state_tax.nm_complete_withholding_reg | Finish New Mexico withholding registration | Create a Taxpayer Access Point (TAP) account and register with the New Mexico Taxation & Revenue Department. This lets us pay and file withholding taxes. | none | An EIN gets provided by the customer or we retrieve it via agency | yes | A customer needs to register themselves with the agency. | no | yes | no | None |
| state_tax.nm_workers_comp_coverage | Indicate coverage under the New Mexico Workers’ Compensation Act | Indicate coverage under the New Mexico Workers’ Compensation Act so we know whether or not to pay the Workers’ Compensation Fee. | none | Applicable by default as long as company has a presence in the state | yes | A customer needs to answer the question whether they eligible for workers comp coverage | no | yes | no | None |
| state_tax.ok_tap_grant | Finish Oklahoma withholding registration | Authorize Gusto with the Oklahoma Tax Commission (OTC). This lets us pay and file withholding taxes. | none | Applicable by default as long as customer has a presence in state. | yes | Customer needs to confirm that they have provided Gusto with Oklahoma Tax Commission | no | yes | no | None |
| state_tax.ok_tap_registration | Finish Oklahoma withholding registration | Create an OkTAP passphrase and register with the Oklahoma Tax Commission (OTC). This lets us pay and file withholding taxes. | none | Customer confirms that they have provided us the OkTAP Approval access | yes | Provide a TAP passphrase | no | yes | no | None |
| state_tax.pa_sui_enrollment | Authorize Gusto for Pennsylvania Department of Labor & Industry account | Authorize 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. | none | Company becomes eligible for unemployment taxes. | yes | Customer needs to confirm that they have provided Gusto a TPA access | no | yes | no | None |
| state_tax.pa_withholding_tpa | Grant access to the Pennsylvania Department of Revenue account | Grant 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. | none | Gusto has requested a TPA access from customer. | yes | Customer needs to confirm that they have provided Gusto a TPA access | no | yes | no | None |
| state_tax.pa_withholding_tpa_shared_secret | Enter Pennsylvania Department of Revenue account Letter ID | Enter 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. | none | Applicable by default as long as customer has a presence in state. | yes | Customer needs to provide a shared secret to Gusto. i.e. Letter ID, etc | no | yes | no | None |
| state_tax.tx_ui_registration | Grant access to the Texas Workforce Commission account | Grant 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. | none | Company becomes eligible for unemployment taxes. \nGusto submits an authorization request. | yes | Customer needs to confirm that they have provided Gusto a TPA access | no | yes | no | None |
| state_tax.va_sui_authorization | Grant access to the Virginia Employment Commission account | Grant 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. | none | Company becomes eligible for unemployment taxes. \nCompany runs their first payroll. \nCustomer provides the Account ID (EIN). “ | yes | Customer needs to confirm that they have provided Gusto a TPA access | no | yes | no | None |
| state_tax.vt_submit_notarized_poa | Send a notarized Power of Attorney form for Vermont | Send a notarized Power of Attorney form for Vermont. This lets us pay and file unemployment taxes. | none | Company becomes eligible for unemployment taxes. \nA PoA form gets generated.” | yes | Sign a POA form | no | yes | no | None |
| state_tax.wa_lni_poa | Grant 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. | none | A PoA form gets generated | yes | Sign a POA form | no | yes | no | None |