Happy New Year! We hope you had a restful holiday season and we are excited to share the many improvements we made in December.

Have questions about anything in the changelog? Reach out to your dedicated Implementation Team.

Unsure who your dedicated team is? Contact us. We’re available to help Monday through Friday between 8am - 5pm PT.

Upcoming Deprecations

With the creation of our new form webhooks, we will be deprecating the form.created and form.updated webhooks in favor of company.form.created,employee.form.updated, etc. This deprecation will occur on January 31, 2023. If you cannot deprecate by then, please contact your support team.

Guides Improvements

New Year, same Gusto Embedded but with new guides! We have updated all of our Guides to be more developer friendly with sample codes and step by step instructions.

API Improvements and Additions

FLSA Tip Credits (aka Minimum Wage Adjustments)

Added new minimum wage adjustment functionality for Employee Jobs/Compensations that will apply minimum wage adjustments to applicable employees when running payroll
Added a new GET endpoint for retrieving minimum wage data for a location.
When creating a job compensation you can now opt in to the minimum wage adjustment adding in the applicable rate you want to use in the tip credit calculations
- When it is time to process payroll any employees who receive an adjustment will automatically be flow through payroll and the amount will be included in the payroll response as a “minimum wage adjustment”.
Added new fields and their descriptions for the payroll object:
withholding_pay_period
skip_regular_deductions
fixed_withholding_rate

Minimum API Versioning

Added minimum API versions which defines the “floor” API version for a particular partner application. To learn more review our API Versioning guide.

Webhooks

Added new events to nearly all of our webhooks including: Payroll (submitted, reversed, processed, paid, partially reversed, canceled) , Employee (onboarded, self onboarding, terminated, deleted), Contractor (onboarded, deactivated, deleted), Company (approved, onboarding, authorized), Signatories (deleted, invited), Employee Job Compensation (deleted).

Miscellaneous API Improvements

Payroll UUID included from creation of Payroll
Added a draft field to forms
- This describes if the form is in a draft state. (E.g. End of year tax forms may be provided in a draft state prior to being finalized.)
Tax Requirement APIs are no longer in beta

Flow Improvements and Additions

End of Year Flows

You can now embed an experience that allows customers to view their basic company information, view their active employees/contractors, view all company/employee/contractor forms (draft and filed), and view/add/adjust their external benefits. All crucial information that needs to be verified for Gusto to make accurate filings and payments.

FLSA Tip Credits (aka Minimum Wage Adjustments)

Added the minimum wage opt-in and the rates to our employee onboarding experience.

Incorporated the adjustment into our run payroll experience, both at the preview level and when an admin clicks into the employee wages

Post-tax employee garnishments have been added to our Employee onboarding

We added an optional step in employee onboarding to set up their garnishments. In that step you can add garnishments, edit garnishments and delete garnishments.

Each garnishments is customizable and includes:

Customized name
Recurring or one-time
Percentage of pay or fixed amount
Whether it’s court ordered (simply cosmetic)

Once configured the garnishment will flow directly to payroll.

Off-Cycle Payroll and Payroll History Flows

We are adding a new embeddable flow that provides you with an easy-to-drop-in experience to create off cycle payroll flows for both Bonuses and Corrections to payrolls. Additionally we are creating a new standalone payroll history flow to provide you with a view of all payrolls they have processed.

Off-Cycle Payroll Flow allows:

Selecting Bonus or Correction Off-Cycle Payroll to create with options for pay period, payment date, employees to include, deductions, contributions, and tax withholding rates.
Editing the employee compensations within the Off-cycle Payroll Flow
Reviewing and submitting the payroll
Viewing and canceling processed Off Cycle payrolls to re-run

Payroll History Flow:

A standalone flow to view both regular and off-cycle processed payrolls

Miscellaneous

We now support the ability to have custom pay dates for a semimonthly pay period in our flows

Documentation Improvements

Adds a new request header to our docs for X-Gusto-API-Version to all paths

Added the version field as required to the update company location endpoint
Fixed typo in garnishment
Added documentation for the update termination endpoint
Updated the required effective field in create a termination