Partner Notification types

Resource table

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?
information_requestAdditional information needed to process payrollIf we do not receive this information as soon as possible, your payroll may not be processed on time.noneGusto's risk team determines that there is additional company information that needs to be collected before the company can be approved.yesCreate an `company_information_requests` flow; company payroll admin must provide answers to the questions via the flow.yesYes, it resolves after the information request is submittedNo
invalid_ssnUpdate %{person_full_name}’s tax infoThis employee's information doesn’t match what’s on file with the Social Security agency. Fixing this will help make sure tax filings go smoothly.entity_type: "Contractor" or "Employee"Employee's SSN verification with the Social Security Administration (SSA) failed. This could happen if the provided SSN is actually an ITIN, as the SSA does not accept ITINs in place of SSNs, or the provided SSN is not on record with the SSA.yesUpdate the employee's informationnoYes, it resolves after the employee's SSN has been validated by the SSANo
bank_error.company_ach_debit_failureUnblock %{payroll_type} payroll for %{payment_check_date}We were unable to debit sufficient funds from %{company_name}’s bank account due to the following bank error: %{bank_error} for the %{payroll_type} payroll on %{payment_check_date}. Please update the company bank account details and re-run payroll, so that employees can be paid by direct deposit.entity_type: "Payroll"Due to a bank error, a debit failed to the company's bank account for the 4-day payrollyesUpdate company bank account details to resolve the provided bank error and re-run payrollnoYes, it resolves after the payroll is re-run and finished processingNo
bank_error.compensation_credit_failureUnable to deposit funds to %{beneficiary_name}We were unable to deposit a recent paycheck to %{beneficiary_name}’s bank account, so these funds of %{amount} will be returned to %{company_name}’s bank account. Once the funds are received, the payment should be made directly to %{beneficiary_name}.entity_type: "Contractor" or "Employee"Due to a bank error, Gusto was unable to deposit funds to an employee or contractor. Because Gusto is unable to hold these funds legally, we have credited the funds to the company bank account.yesCredited compensation to the company's bank account should be made directly the contractornoNoNo
bank_error.contractor_ach_credit_failureUpdate %{contractor_name}’s bank account detailsWe were unable to deposit a recent paycheck to %{contractor_name}’s bank account due to the following bank error: %{bank_error}. After their bank account details are updated, we will attempt to redeposit the funds in the next business day.'entity_type: "BankAccount", reference_type: "Contractor"Due to a bank error, Gusto was unable to credit funds to the contractor's bank accountyesUpdate contractor bank account detailsnoYes, it resolves after the contractor has updated their bank account detailsNo
bank_error.contractor_ach_debit_failureFailed to debit funds from %{contractor_name}We were unable to debit funds from %{contractor_name}’s bank account due to the following bank error: %{bank_error}.entity_type: "BankAccount", reference_type: "Contractor"Due to a bank error, Gusto was unable to debit funds from a contractor's bank account. This is usually related to a contractor payment reversal.noN/A - informationalnoNoNo
bank_error.employee_ach_credit_failureUpdate %{employee_name}’s bank account detailsWe were unable to deposit a recent paycheck to %{employee_name}’s bank account due to the following bank error: %{bank_error}. After their bank account details are updated, we will attempt to redeposit the funds in the next business day.entity_type: "BankAccount", reference_type: "Employee"Due to a bank error, Gusto was unable to credit funds to the employee's bank accountyesUpdate employee bank accountnoYes, it resolves after the employee has updated their bank account detailsNo
bank_error.employee_ach_debit_failureFailed to debit funds from %{employee_name}We were unable to debit funds from %{employee_name}’s bank account due to the following bank error: %{bank_error}. Please recover these funds directly from %{employee_name}, as we cannot retry the debit.entity_type: "BankAccount", reference_type: "Employee"Due to a bank error, Gusto was unable to debit funds from the employee's bank account. This is usually related to a payroll reversal.yesRecover funds directly from the employeenonono
bank_error.fast_payroll_ach_debit_r01_first_failureUnable to debit sufficient funds for %{payment_check_date} payrollPayroll for %{payment_check_date} processed successfully, but we were unable to debit sufficient funds from the associated bank account. A redebit attempt will be made on %{next_attempt_date}.entity_type: "Payroll"Due to an insufficient funds bank error, Gusto was unable to debit payroll funds from the company bank account. This occurs when a company is on faster payment speed.yesAdd sufficient funds to the company's bank account. Gusto will attempt another redebit at the end of the business day.nonoyes
bank_error.fast_contractor_payment_ach_debit_r01_first_failureUnable to debit sufficient funds for %{payment_check_date} contractor paymentContractor payment for %{payment_check_date} processed successfully, but we were unable to debit sufficient funds from the associated bank account. A redebit attempt will be made on %{next_attempt_date}.entity_type: "ContractorPayment"Due to an insufficient funds bank error, Gusto was unable to debit contractor payment funds from the company bank account. This occurs when a company is on faster payment speed.yesAdd sufficient funds to the company's bank account. Gusto will attempt another redebit at the end of the business day.nonoyes
bank_error.reconciliation_payroll_ach_debit_failureUnable to debit funds for %{payment_check_date} reconciliation payrollWe were unable to debit funds from %{company_name}’s bank account due to the following bank error: %{bank_error} for the reconciliation payroll on %{payment_check_date}. We are unable to retry the debit, so please make the tax payments directly.noneDue to a bank error, Gusto was unable to debit funds from the company bank account for a recent reconciliation payroll.yesContact support to determine what tax payments need to be made to what agenciesnonono
recovery_case.connect_new_bankConnect a new bank account to unblock payrollWe weren’t able to debit funds for the %{date} %{event}. To pay the team on time, connect a new bank account as soon as possible.entity_type: "RecoveryCase"Due to an R02 bank error, Gusto was unable to debit funds for a past payroll or contractor payment. Please note that payroll will be blocked until the amount has been recovered.yesConnect a new company bank account and initiate a new redebit via API call or via `company_recovery_cases` flowyesYes, it resolves after a redebit has been initiated on the recovery caseno
recovery_case.insufficient_fundsAdd sufficient funds to unblock payrollWe weren’t able to debit funds for the %{date} %{event}. To pay the team on time, check that the associated bank account has sufficient funds as soon as possible.entity_type: "RecoveryCase"Due to an R01 bank error, Gusto was unable to debit funds for a past payroll or contractor payment. Please note that payroll will be blocked until the amount has been recovered.yesAdd sufficient funds to the company's bank account and initiate a new redebit via API call or via `company_recovery_cases` flowyesYes, it resolves after a redebit has been initiated on the recovery caseno
recovery_case.unfreeze_bank_accountUnfreeze bank account to unblock payrollWe weren’t able to debit funds for the %{date} %{event}. To pay the team on time, unfreeze the associated bank account as soon as possible.entity_type: "RecoveryCase"Due to an R16 bank error, Gusto was unable to debit funds for a past payroll or contractor payment. Please note that payroll will be blocked until the amount has been recovered.yesUnfreeze the company bank account and initiate a new redebit via API call or via `company_recovery_cases` flowyesYes, it resolves after a redebit has been initiated on the recovery caseno
recovery_case.verify_bank_accountVerify bank account details to unblock payrollWe weren’t able to debit funds for the %{date} %{event}. To pay the team on time, verify the associated bank account as soon as possible.entity_type: "RecoveryCase"Due to a bank error, Gusto was unable to debit funds for a past payroll or contractor payment. Please note that payroll will be blocked until the amount has been recovered.yesVerify company bank account details and initiate a new redebit via API call or via `company_recovery_cases` flow. Contact support for further assistanceyesYes, it resolves after a redebit has been initiated on the recovery caseno
recovery_case.redebit_successfulDebit for %{company_name} was successfulWe wanted to let you know that our attempt to debit ${company_name}’s bank account for your %{payment_check_date} payday was successful. Your ability to process payroll has been reinstated.

Please ensure that your bank account has sufficient balance for future Paydays to ensure that your employees continue getting paid in a timely manner. In addition, if bank errors continue to be an issue your service may be interrupted. If you foresee a bank error in the future, please contact us so we may assist you with this matter.
entity_type: "RecoveryCase"Redebit was successfulnoN/Anonono
invalid_signatoryVerify company signatory informationWe couldn’t verify %{signatory_name}’s identity—make sure their details are accurate.entity_type: "Signatory"Invalid signatory informationyesRe-enter signatory information, reinitiates identity verification process automaticallyyesyesno
soft_suspendedAuthorize Gusto to pay and file taxesWe couldn’t authorize ourselves with the %{agent_name}, which means we can’t pay or file taxes, and payroll is blocked. Update this info as soon as possible.
OR
We couldn’t complete a %{agent_name} tax filing due to %{reason}. Update this info as soon as possible to keep running payroll.
OR
The IRS rejected Form 8655 due to %{reason}, which means we can’t pay or file taxes, and payroll is blocked. Correct and re-sign this form as soon as possible.
OR
We won’t be able to pay and file taxes to %{agent_name} due to %{reason}. Update this info as soon as possible to keep running payroll.
noneDue to specific state tax setup issues, Gusto was unable to authorize itself as the reporting agent. This means that as a payroll service provider, Gusto is unable to pay or file taxes on the company's behalf. Please note that the company is "soft suspended", which means if the issue is not resolved, the company will be blocked from running payroll.yesWe recommend contacting our support team to help determine the precise issue and resolution step. These steps can vary widely depending on the specific state tax agency involved.No (but countdown pending)Yes, it resolves after the underlying state tax setup issue is remediatedno
auto_payroll.disabledAutomatic payroll has been disabledDue to a recent account change, automatic payroll has been disabled. Run the next scheduled payroll manually to make sure the team is paid on time.noneSee section 'actions that will disable autopilot' https://support.gusto.com/article/999755421000000/Use-and-manage-Payroll-on-AutoPilotyesRun the next scheduled payroll manually. To re-enroll in automatic payroll, fix the underlying issue and then use the update pay schedule API to re-enroll in automatic payroll.nonoyes (after 7 days)
auto_payroll.excluded_employeesAutomatic payroll excluded some employees for %{payment_check_date} payrollUnfortunately, since we're missing state tax details for %{states_to_sentence}, automatic payroll excluded the following employees from %{payment_check_date} payroll: %{employees}. Please provide missing tax details to include the employees in the next payroll, and run an off-cycle payroll if they still need to be paid for this pay period.entity_type: "Employee"Missing state tax detailsyesUpdate missing state tax details, and run an off-cycle payroll to pay the excluded employees.nonoyes (after 7 days)
auto_payroll.failedAutomatic payroll failed for %{payment_check_date} payrollUnfortunately, automatic payroll failed for %{payment_check_date} payroll. Please run payroll manually to make sure the team is paid on time.entity_type: "Payroll"Either the company is not allowed to run payroll, or the payroll itself failed.yesRun the payroll manually.nonoyes (after 7 days)
sign_company_documentsPayroll may be blocked: Sign company documentsWe’ve created and filled out required government documents. To run payroll, all that’s left is an e-signature!noneForm needs signingyesSign the relevant formyesYes, it resolves after the relevant form is signedno
reconciliation_payroll_createdPayroll tax debit is scheduled for %{debit_date}We ran a tax reconciliation to detect updated tax rates and other tax adjustments for %{company_name}, and determined that we need to correct taxes by debiting %{company_name}’s bank account ending in %{bank_account_last_four_digits} for %{total_debit_amount} on %{debit_date} to pay an adjustment for %{tax_period}.entity_type: "Payroll"Reconciliation payroll rannoN/Anonono
company_rejected.rejectedInformation regarding account approvalUpon review, %{company_name} has not been approved for our platform. Please be advised, this decision is final and cannot be reversed.noneGusto has elected to not approve the specified company for our platform.noN/Ayesnono
company_rejected.likely_fraudAccount has been deactivatedAfter extensive review, the account for %{company_name} has been deactivated. This decision is final and cannot be reversed. Payroll can no longer be run.noneGusto has rejected a company due to suspected fraudnoContact support if you believe this was done in erroryesyesno
company_rejected.bank_errorsDeactivation noticeRepeated issues debiting payroll funds for %{company_name} has resulted in account deactivation. This action is irreversible. Please initiate the offboarding process to ensure tax information is correct. If this is not done within 30 days, we will cancel the account, and any unpaid taxes will be returned.noneRepeated errors withdrawing funds for payrollyesComplete company offboardingyesyesno
company_rejected.suspicious_bankIssue with a funding accountOur platform does not support the current funding method for %{company_name}. In order to proceed, please update the company’s funding bank account to a transactional checking account, then reach out for assistance unblocking the account.noneBank account was flagged as not supported.noContact support if you believe this was done in erroryesnono
account_suspension.pendingAccount may be closed: Authorize Gusto to pay and file taxesWe couldn’t authorize ourselves with the %{agent_name}, which means we can’t pay or file taxes, and payroll is blocked. Update this info as soon as possible to prevent this account from being closed.
OR
We couldn’t complete a %{agent_name} %{failure_type} due to %{reason}. Update this info as soon as possible to prevent this account from being closed.
OR
The IRS rejected Form 8655 due to %{reason}, which means we can’t pay or file taxes, and payroll is blocked. Correct and re-sign this form as soon as possible to prevent this account from being closed.
OR
We couldn’t authorize ourselves with the %{agent_name} due to %{reason}, which means we can’t pay or file taxes, and payroll is blocked. Update this info as soon as possible to prevent this account from being closed.
noneDue to specific state tax setup issues, Gusto was unable to authorize itself as the reporting agent. This means that as a payroll service provider, Gusto is unable to pay or file taxes on the company's behalf. Please note that the company is "pending suspension", which means the company is blocked from running payroll and the account will be closed if the issue is not resolvedyesWe recommend contacting our support team to help determine the precise issue and resolution step. These steps can vary widely depending on the specific state tax agency involved.yesYes, it resolves after the underlying state tax setup issue is remediatedno
account_suspension.closedAccount has been closed%{company_name}’s payroll account has been closed. If there are questions on suspension elections, including confirming responsibility of tax payments or filings for the remainder of the calendar year, please contact support.noneA company account has been closednoN/Ayesnono
mi_form_5080_quarterly_reminderPlease file MI 5080 form for Q%{quarter}We will file the MI 5080 form with all required withholding and payroll tax details but without any sales tax details. If %{company_name} owes any sales or use tax, please file an additional paper MI 5080 form for Q%{quarter}.noneEnd of quarteryesFile MI 5080 if applicablenonoyes
mi_form_5081_annual_reminderPlease file an MI 5081 form for %{year}We will file the MI 5081 form with all required withholding and payroll tax details but without any sales tax details. If %{company_name} owes any sales or use tax, please file an additional paper MI 5081 form for %{year}.noneEnd of yearyesFile MI 5081 if applicablenonoyes
missed_anchor_pay_dayFirst payroll deadline missed%{company_name} missed their first payroll which was scheduled for %{payroll_date}. Please revisit the payroll schedule setup and provide a new first payroll date. If any payrolls were run using a different payroll system they will need to be provided to complete onboarding.noneAnchor pay day passed without running payrollyesPick a new anchor pay dateyesyesno
employee_contractor_bank_account.updated%{member_name} Bank Account Updated'%{member_name}, your bank account details were recently updated.entity_type: "Contractor" or "Employee"Employee/Contractor updates their bank account detailsnoN/Anonono
bank_account.contractor_payments_cancelledBank Account Update cancelled Contractor PaymentsContractor payments were cancelled due to %{company_name}’s update to their bank account.entity_type: "ContractorPayment"Company Bank account updatenoN/Anonono
bank_account.payrolls_cancelledBank Account Update cancelled PayrollsPayrolls were cancelled due to %{company_name}’s update to their bank account.entity_type: "Payroll"Company Bank account updatenoN/Anonono
bank_error.company_bank_verification_needs_reviewReview the recent bank verification test transactionsWe completed a bank verification test transaction with company bank account %{bank_account_last_four_digits} but received error %{bank_error}. We updated our records accordingly with the bank account information sent from the financial institution and advise reviewing the changes.entity_type: "BankAccount"A test transaction to the company's bank account completed but returned an erroryesUpdate company bank account detailsnoyesno
bank_error.company_bank_verification_failureUnblock future company transactionsWe attempted a test transaction with company bank account %{bank_account_last_four_digits}. The transaction failed with message %{bank_error}. This critical error will prevent future payments. Please update the company’s bank account details.entity_type: "BankAccount"Due to a bank error, A test transaction to the company's bank account failedyesUpdate company bank account detailsyesyesno
bank_error.company_bank_transaction_needs_reviewReview the recent company transaction detailsWe completed a transaction with company bank account %{bank_account_last_four_digits} but received error %{bank_error}. We updated our records accordingly with the bank account information sent from the financial institution and advise reviewing the changes.entity_type: "BankAccount"A transaction to the company's bank account completed but returned an erroryesUpdate company bank account detailsnoyesno
bank_error.company_bank_transaction_failureUnblock future company transactionsWe attempted a transaction with company bank account %{bank_account_last_four_digits}. The transaction failed with message %{bank_error}. This critical error will prevent future payments. Please update the company’s bank account details.entity_type: "BankAccount"Due to a bank error, A transaction to the company's bank account failedyesUpdate company bank account detailsyesyesno
bank_error.contractor_ach_transaction_needs_reviewReview %{contractor_name}’s recent bank transaction detailsWe completed a transaction with %{contractor_name}’s bank account ending in %{bank_account_last_four_digits} but received error %{bank_error}. We updated our records accordingly with the bank account information sent from the financial institution and advise reviewing the changes.entity_type: "BankAccount", reference_type: "Contractor"A transaction to the contractor's bank account completed but returned an erroryesUpdate contractor bank account detailsnoyesno
bank_error.employee_ach_transaction_needs_reviewReview %{employee_name}’s recent bank transaction detailsWe completed a transaction with %{employee_name}'s bank account ending in %{bank_account_last_four_digits} but received error %{bank_error}. We updated our records accordingly with the bank account information sent from the financial institution and advise reviewing the changes.entity_type: "BankAccount", reference_type: "Employee"A transaction to the employee's bank account completed but returned an erroryesUpdate employee bank account detailsnoyesno
year_round_tax_accuracy.distribute_final_1099_formsDistribute 1099s before the IRS deadlineIt’s time to distribute contractor tax forms.noneNotification will be created in January, since 1099 forms must be distributed to contractors by January 31st.yesDistribute 1099 formsnonoyes
year_round_tax_accuracy.distribute_final_w2_formsDistribute W-2s before the IRS deadlineIt’s time to distribute employee tax forms.noneNotification will be created in January, since W-2 forms must be distributed to employees by January 31st.yesDistribute W2 formsnonoyes
year_round_tax_accuracy.review_draft_1099sReview and correct year-to-date 1099s as neededReview contractors’ draft forms and make any necessary corrections before we finalize these. This helps avoid complicated corrections later.noneNotification will be created in November, since finalized 1099 forms must be ready by December 31st.yesReview draft 1099 formsnonoyes
year_round_tax_accuracy.review_draft_w2sReview and correct year-to-date W-2s as neededReview employees’ draft forms and make any corrections before we finalize these. This helps avoid complicated corrections, penalties, or interest later.noneNotification will be created in November, since finalized W-2 forms must be ready by December 31st.yesReview draft W2 formsnonoyes
year_round_tax_accuracy.review_special_compensation_for_w2sReview and add any special compensation from %{year} for W-2sTo help us correctly generate W-2s, review common special compensation types (like NSOs, allocated tips, etc.) and add any relevant amounts.noneNotification will be created in November/December, since finalized W-2 forms must be ready by December 31st.yesReview special compensation for W2snonoyes
fast_ach_deactivated.invalid_payroll_ach_speedWe couldn’t process a payroll in %{speed}We’re unable to process a payroll for %{payroll_check_date} since the payroll is above the faster processing limit. Instead, employees will be paid on %{updated_check_date}.entity_type: "Payroll"Payroll amount is above partner managed limitnoN/Anonoyes (5 days after payroll check date)
fast_ach_deactivated.invalid_contractor_payment_ach_speedWe couldn’t process contractor payments in %{speed}After reviewing %{company_name}'s bank account, we’re unable to process their contractor payments. Instead, contractors will be paid on %{updated_check_date}.entity_type: "ContractorPayment"Bank fraud with contractor paymentsnoN/Anonoyes (5 days after contractor payment check date)
fast_ach_deactivated.bank_verification_debit_failureUnable to verify company bank accountWe received an Insufficient Funds bank error when attempting to verify %{company_name}’s bank account ending in %{bank_account_last_four_digits}, so direct deposit speed has been changed to 4 days. We’ll evaluate payroll history and debits in 3 months to determine if we can switch back to the original, faster speed.entity_type: "BankAccount"Verification debit failure (No sufficient funds) from company bank accountnoN/Anonono
fast_ach_deactivated.debit_failureUnable to debit funds from company bank accountWe were unable to debit funds from %{company_name}’s bank account ending in %{bank_account_last_four_digits} on %{nacha_entry_return_date}, so direct deposit speed has been changed to 4 days. The speed will be automatically switched back to the original, faster speed after 3 months of running payroll with no further issues.entity_type: "BankAccount"Debit failure from company bank accountnoN/Anoyesno
fast_ach_deactivated.debit_failure_in_last_one_yearUnable to debit funds from company bank accountWe were unable to debit funds from %{company_name}’s bank account ending in %{bank_account_last_four_digits} multiple times in the last 12 months, so direct deposit speed has been changed to 4 days. We’ll evaluate payroll history and debits in 12 months to determine if we can switch back to the original, faster speed. To get back on track, make sure to run at least 1 successful payroll per month without bank failures.entity_type: "BankAccount"Debit failures from company bank account over last yearnoN/Anoyesno
fast_ach_deactivated.debit_failure_in_last_two_yearsUnable to debit funds from company bank accountWe were unable to debit funds from %{company_name}’s bank account ending in %{bank_account_last_four_digits} multiple times in the last 24 months, so direct deposit speed has been changed to 4 days. We’ll evaluate payroll history and debits in 12 months to determine if we can switch back to the original, faster speed. To get back on track, make sure to run at least 1 successful payroll per month without bank failures.entity_type: "BankAccount"Debit failures from company bank account over last two yearsnoN/Anoyesno
fast_ach_deactivated.debit_failure_slow_recoveryUnable to debit funds from company bank accountWe were unable to debit funds from %{company_name}’s bank account ending in %{bank_account_last_four_digits} on %{nacha_entry_return_date}, so direct deposit speed has been changed to 4 days. We’ll evaluate payroll history and debits in 6 months to determine if we can switch back to the original, faster speed. To get back on track, make sure to run at least 1 successful payroll per month without bank failures.entity_type: "BankAccount"Debit failure from company bank accountnoN/Anoyesno
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
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
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.

Visit 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.yesyes - will get resolved after 14 days and account_suspension.pending notification will be sentno
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
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
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
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.

Please reach out to our support team for instructions and help.
noneWhen setting up state of Massachusetts and no access to accountyesGive access to accountnoyesno
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
pending_filing_surveyFinish %{period_name} filingsContact support to finish %{period_name} filings. The information required is related to the number of officers and officer earnings for the %{period_name} filing period. This helps us file %{filing_survey_period_type} forms correctly.noneWhenever information is needed in order to complete filingsyesContact support to complete filing surveynoyesno
state_tax_agency_ein_fein_mismatchFix an error with the %{state_agency_name} accountPlease review the %{state_agency_name} account information (account number, effective date, company name, etc). We need correct account info to pay and file taxes accurately and on time.noneWhen the company state does not match the tax agencies listed for that stateyesProvide tax agency that matches the statenoyesno
state_tax_setup_blank_einRegister with %{full_state_name} tax agencies and share account detailsWe need more %{full_state_name} tax information as soon as possible to pay and file taxes.noneWhen ein is blankyesFill the einnoyesno
state_tax_setup_ein_fails_validation_rulesCorrect account number for %{full_state_name} tax agenciesWe need more %{full_state_name} tax information as soon as possible to pay and file taxes.noneIf ein is manually or automatically inferred incorrect or fails valdiation rulesyesFill the correct einnoyesno
employee_missing_ak_occupational_codeAdd an Alaska occupational code for %{employee_name}We need an Alaska occupational code for all employees to accurately file quarterly Alaska payroll taxes.'entity_type: "Employee"When employee is missing Alaska occupational codeyesFill in the the Alaska occupational code for employeenoyes (when employee does not stay in the state for the current year, it auto resolves as irrelevant)no
employee_missing_in_occupational_codeAdd an Indiana occupational code for %{employee_name}We need an Indiana occupational code for all employees to accurately file quarterly Indiana payroll taxes.entity_type: "Employee"When employee is missing Indiana occupational codeyesFill in the the Indiana occupational code for employeenoyes (when employee does not stay in the state for the current year, it auto resolves as irrelevant)no
employee_missing_la_occupational_codeAdd a Louisiana occupational code for %{employee_name}We need a Louisiana occupational code for all employees to accurately file quarterly Louisiana payroll taxes.entity_type: "Employee"When employee is missing Louisiana occupational codeyesFill in the the Louisiana occupational code for employeenoyes (when employee does not stay in the state for the current year, it auto resolves as irrelevant)no
employee_missing_wa_occupational_codeAdd a Washington occupational code for %{employee_name}We need a Washington occupational code for all employees to accurately file quarterly Washington payroll taxes.entity_type: "Employee"When employee is missing Washington occupational codeyesFill in the the Washington occupational code for employeenoyes (when employee does not stay in the state for the current year, it auto resolves as irrelevant)no
home_and_work_address_are_far_apartVerify %{employee_name}’s work location—it looks far from homeTo accurately pay and file taxes, we need %{employee_name}’s correct work location. Verify it (even if they work from home) now.entity_type: "Employee"When distance between home and work address exceeds maximum miles (100 miles)yesProvide home and work address within 100 milesnoyesno
vt_employee_health_care_coverageConfirm Vermont employees’ healthcare coverageWe need accurate employee health care coverage elections to correctly calculate taxes in Vermont.noneWhen company operates in VT and requires EOQ questionyesFill in the employee health care coveragenoyesno
wire_in.confirm_wire_in_transferWire funds for %{payment_date} payrollWe need to receive the funds by %{deadline_time} to pay employees on time. entity_type: "Wire In Request" entity_type: "Payroll"When a company submits a payroll with risk blockers and selects the Wire In optionyesSubmit a Wire Innoyesno
wire_in.deadline_passed_payrollWire deadline passed for %{payment_date} paymentWe didn’t receive funds for the %{payment_date} payment by the %{cutoff_time} PDT deadline. If you have not sent the funds already, the payroll will be automatically canceled.entity_type: "Wire In Request" entity_type: "Payroll"When the payment date to fund a payroll through a wire in has passednoN/Anoyesno
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).
First payroll gets run.
Company gets unsuspended
yesProvide us the last payment amount with the agencynoyesno
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 taxesnoyesno
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.
Company runs their first payroll.
Customer provides the Account ID (EIN)
yesCustomer needs to confirm that they have provided Gusto a TPA accessnoyesno
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 accessnoyesno
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 HInoyesno
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.noyesno
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 Revenuenoyesno
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 agencynoyesno
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 agencynoyesno
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 IDnoyesno
state_tax.nm_complete_unemployment_regFinish New Mexico unemployment registrationAuthorize Gusto with the New Mexico Department of Workforce Solutions (DWS). This lets us pay and file unemployment taxes.noneA company becomes liable for unemployment taxes. A customer registers themselves with the agency.yesCustomer needs to provide Gusto an accessnoyesno
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.noyesno
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 coveragenoyesno
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 Commissionnoyesno
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 passphrasenoyesno
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 accessnoyesno
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 accessnoyesno
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, etcnoyesno
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.
Gusto submits an authorization request.
yesCustomer needs to confirm that they have provided Gusto a TPA accessnoyesno
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.
Company runs their first payroll.
Customer provides the Account ID (EIN). "
yesCustomer needs to confirm that they have provided Gusto a TPA accessnoyesno
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.
A PoA form gets generated."
yesSign a POA formnoyesno
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 formnoyesno
company_setup.sf_payroll_expensePay San Francisco's gross receipts and payroll expense taxesPay San Francisco's gross receipts and payroll expense taxes. Since these taxes aren't related to payroll, we can't take care of them. They apply to anyone doing business in San Francisco (we recommend paying them together).noneAddition of a San Francisco addressnotax handled outside of Gusto Embedded. Need to work directly with the SF city agency and confirm completionnoyesno
company_setup.multi_state_retirement_mandatesSet up a required retirement planMultiple states require that companies offer a retirement plan for employees. Stay compliant and boost retention with an affordable retirement plan.noneonce 401k is createdyesSet up a retirement plan required by multiple statesnoyesno
company_setup.multi_state_retirement_mandates_past_dueSet up a retirement for compliance with state lawsRequirements to offer retirement plans are in effect. Set up a plan as soon as possible to avoid monetary fines and boost retention.noneonce 401k is createdyesSet up a retirement plan required by multiple statesnoyesno
company_setup.pay_schedulePayroll is blocked: Set up a pay scheduleTell us how often to pay the team, as well as their first pay day. Payroll can't be run until this is done.noneCompany has been created but still needs to set up a pay scheduleyesProvide how often to pay the team, as well as their first pay dayyesnono
company_setup.reverse_wireSet up reverse wireSet up reverse wire. This will re-enable faster payroll. For now, payroll can still be run four business days before payday.nonecompany sets up a reverse wirenoN/Anoyesno
bank_error.continue_instant_verificationPayroll is blocked: Verify bank accountWe'll use this bank account to pay both employees and taxes. Payroll can't be run until this is done.noneresolving all pending items for funding methodyes Verify company bank accountyesyesno
payroll_setup.pay_schedule_setup_not_completePayroll is blocked: Assign each employee to a pay scheduleSome employees don't have a pay schedule set up yet. Payroll can't be run until this is done.none- Employee or employment changed and needs to be assigned a pay schedule.
- Pay schedule setup not complete
yesAssign each employee a payroll scheduleyesyesno
payroll_setup.report_external_previous_payrollsPayroll is blocked: Share latest payroll recordsThe desired first pay date was missed. Share any new payroll records with us so we can calculate taxes correctly.nonePayroll Blocked due to incomplete external payrollsyesReport previous historical payroll recordsyesyesno
payroll_setup.assign_company_signatoryPayroll is blocked: Assign a company signatoryAssign a company signatory. This person is authorized to sign company documents. Payroll can't be run until the signed docs have been added.nonewhen company is created or signatory is changedyesAssign company signatoryyesyesno
company_setup.company_address_invalidPayroll is blocked: Update business addressA company address doesn't look right‚ update it as soon as possible so we can calculate taxes correctly and run payroll for this location.nonewhen geocode error occur for company addressyesUpdate company business addressyesyesno
company_setup.missing_mandatory_sick_time_policySet up a sick time off policyAt least one company work location requires businesses to provide a sick time off policy.noneonce new company and addresses are savedyesSet up a sick time off policynonono
company_setup.elect_shareholdersIdentify all shareholders who own over 2% of sharesIdentify all shareholders who own over 2% of shares. This helps us tax health benefits correctly.noneonce the taxpayer type update is savedyesSelect and add company shareholdersnoyesno
run_bank_holiday_payrollA bank holiday is coming up‚ run payroll earlier than usual %{pay_schedule_label}Make sure that the upcoming bank closure doesn't disrupt payroll. Run payroll one day earlier than usual. Approve pay for the %{pay_period} pay period.entity_type: "PaySchedule"An unprocessed pay period has a holiday between the original debit date and check dateyesRun payroll one day earliernoyesno
run_bank_holiday_saturday_payroll%{holidays_are} on a Saturday this year‚ run payroll as usual %{pay_schedule_label}For bank holidays falling on a Saturday, banks will be open the Friday before! That means payroll for the %{pay_period} pay period can be run on the normal schedule.entity_type: "PaySchedule"An unprocessed pay period has a holiday between the original debit date and check date but the holiday is a SaturdayyesRun payroll on the normal schedulenoyesno
employees_incomplete_stateFinish setting up %{employee_name}’s state taxesWe need this to correctly calculate their payroll taxes in %{full_state_name}.entity_type: "Employee"Employee information has been updated leaving their state tax setup incompleteyesUpdate employee state tax informationyesyesno
employees_termination_payrollRun dismissal payroll for %{employee_name}%{employee_name} %{was_or_will_be} dismissed on %{dismissal_date}, but needs to be paid for the %{time_period}.entity_type: "Employee"Employee has been terminated but needs to be paid out for a payrollyesRun dismissal payrollnoyesno
end_of_quarter_payroll_filingsView and monitor Q%{quarter} filingsStay compliant by reviewing and monitoring tax filings for Q%{quarter}. Although you have authorized a payroll provider to file your payroll returns and make tax payments for your employees, you are ultimately responsible for them. The IRS recommends enrollment in the U.S. Treasury Department's Electronic Federal Tax Payment System to monitor and ensure that tax payments are made in a timely manner. Most state tax agencies also offer a way to verify tax payments. Please contact the appropriate state offices directly for details.noneOne day before end of quarter a reminder is triggered if you ran payroll to make sure your tax payments are filednoN/Anonono
pay_schedule_transitionRun transition payroll%{labelTo transition to the new pay schedule correctly, a transition payroll will need to be run for the %{payment_period} pay period.entity_type: "PaySchedule"Employees change pay schedulesRun transition payrollyesyesno
update_min_wagesMinimum wage is increasing: Check employees' profiles%{minimum_wage_description} will increase on %{increase_date}. Check tipped employees' profiles to make sure they're in the right minimum wage category.'noneMinimum wages is increasingDouble check employees are in the right minimum wage categorynoyesno
employee_setup.employee_missing_wv_occupational_codeAdd an occupational code for %{employee_name}We need a West Virginia occupational code for all employees to accurately file quarterly West Virginia payroll taxes.entity_type: "Employee"West Virginia Employee State Tax information is missing their occupational codeUpdate Occupational code for Employee state tax informationnonono
employee_setup.employees_waiting_for_reviewReview %{employee_name}'s details to pay themReview %{employee_name}'s details to pay them. They successfully entered their personal and withholding details. Finish adding them to Gusto so they can be paid.entity_type: "Employee"Employee information entered and needs review to finish onboardingFinish Reviewing employee information to complete their onboardingyesyesno
employee_setup.nc_w4_filingFile %{employee_name}'s NC-4File %{employee_name}'s NC-4. The NC-4 lets us withhold the correct amount of state income tax for %{employee_name}.entity_type: "Employee"An employee requires form NC-4Submit form NC-4nonono
employee_bank_verification_failureUnblock future employee transactionsWe attempted a bank verification test transaction with %{employee_name}’s bank account %{bank_account_last_four_digits}. The transaction failed with message %{bank_error}. This critical error will prevent future payments. Please update the employee's bank account details.entity_type: "BankAccount", reference_type: "Employee"Failed test bank transaction for employeeUpdate employee bank account detailsyesyesno
earned_faster_payment.enrolledEligibility requirements for faster payment%{company_name} must meet eligibility requirements for faster payroll. Until then, use wire transfers or 4-day ACH speed. Requirements: Pass a %{days_criteria} day period and run %{successful_payments_criteria} successful payment(s).N/ACompany must meet eligibility for faster paymentMeet eligibility requirements to earn faster paymentsnoyesno
earned_faster_payment.finishedCompany is eligible for faster payroll%{company_name} is now eligible for faster direct deposit speed.N/ACompany meets eligibility requirements for faster paymentsN/Anonono
wire_in.confirm_earned_faster_payment_payrollWire funds for %{payment_date} payrollWe didn’t receive funds for the %{payment_date} payment by the %{deadline_time} deadline. If you have not sent the funds already, the payroll will be automatically canceled.entity_type: "Wire In Request" entity_type: "Payroll"When a company that must meet eligibility requirements for faster payment submits a payroll with risk blockers and selects the Wire In optionSubmit a Wire Innoyesno
wire_in.payroll_payment_confirmedWire funds for payroll confirmedWire funds for %{payment_date} payroll confirmed.entity_type: "Wire In Request" entity_type: "Payroll"Wire in funds received for payrollN/Anonono