GuidesAPI ReferenceChangelogAPI PolicyAPI StatusGusto Security

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, what triggers it, whether it is actionable or not, whether it is payroll blocking, and whether it expires.

CategoryTitleMessageTriggerActionableAction ItemPayroll BlockingResolves?Expires?
information_requestAction required: Additional information needed to process payrollIf we do not receive this information as soon as possible, your payroll may not be processed on time.Gusto'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_ssnAction required: Update %{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.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_failureAction required: Unblock %{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.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}.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_failureAction required: Update %{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.'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}.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_failureAction required: Update %{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.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.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}.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}.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
recovery_case.connect_new_bankAction required: Connect 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.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_fundsAction required: Add 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.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_accountAction required: Unfreeze 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.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_accountAction required: Verify 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.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
invalid_signatoryAction required: Verify company signatory informationWe couldn’t verify %{signatory_name}’s identity—make sure their details are accurate.Invalid signatory informationyesRe-enter signatory information, reinitiates identity verification process automaticallyyesyesno
soft_suspendedAction required: 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.
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.
Due 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.See 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.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.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!Form 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}.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.Gusto 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, please offboard in order to transition to a new payroll solution.Gusto has rejected a company due to suspected fraudnoContact Gusto 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.Repeated errors withdrawing funds for payrollyesComplete offboarding steps on the Gusto dashboardyesyesno
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.Bank account was flagged as not supported.noContact Gusto support if you believe this was done in erroryesnono
account_suspension.pendingAccount may be closed: Authorize Gusto to pay and file taxes"We 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.
Due 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 closedWe want to do our best to make sure %{company_name}’s transition goes smoothly.A 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}.End 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}.End 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.Anchor 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.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.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.Company Bank account updatenoN/Anonono
bank_error.company_bank_verification_needs_reviewReview the recent bank verification test transactionsWe completed a test transaction with company bank account %{bank_account_last_four_digits} but received error %{bank_error}. Please update the company’s bank account details to resolve.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.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}. Please update the company’s bank account details to resolve.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.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}. Please update the %{contractor_name}’s bank account details to resolve.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}. Please update the %{employee_name}’s bank account details to resolve.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.Notification 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.Notification 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.Notification 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.Notification 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.Notification 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}.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}.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.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.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.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.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.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.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.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.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.yesyesdue_at: pending company suspension date (14 days)
state_tax.al_sui_poaSend a notarized Power of Attorney form for AlabamaThis lets us pay and file unemployment taxes.If 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 accountThis lets us monitor Massachusetts tax account info for changes, to help avoid notices, penalties, and interest.When setting up state of Massachusetts and no access to accountyesGive access to accountnoyesno
state_tax.ga_stateFinish Georgia registrationWe need one last detail before we can file tax returns.Did 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 accountWe can’t pay or file taxes without this access.When 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.When 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.Whenever information is needed in order to complete filingsyesContact support to complete filing surveynoyesno