Connect Gusto Payroll
Connect Gusto payroll, match your team and time off policies, and see which fields Gusto now controls.
Gusto syncing sends approved hours and time off from JobWise Pro to Gusto, and copies pay and time off policies from Gusto back. Connect it from Integrations in Settings, then match each team member and time off policy to Gusto. For the page itself, see Integrations. Connecting, setting up, and disconnecting require full settings access (src/routes/dashboard/[id]/settings/integrations/+page.svelte:683, 706).
Connect Gusto
The Gusto row offers a connection only when time tracking is on. Introduction to Time Tracking covers the module (src/routes/dashboard/[id]/settings/integrations/+page.svelte:700-707).
- Open Integrations in Settings.
- In the Gusto row, click Connect Gusto.
- If the row shows Time tracking settings instead, click it, turn on time tracking, then return to Integrations.
- Sign in to Gusto and approve the connection.
The row names your Gusto company and shows when it last synced. Its button reads Set up (src/routes/dashboard/[id]/settings/integrations/+page.svelte:217-222, 689).
Match team members to Gusto people
Each member needs one Gusto employee or contractor before their approved hours can go to Gusto. Add members first on the time tracking settings page (src/lib/components/gusto/GustoPeopleSection.svelte:159-167).
- In the Gusto row, click Set up. The Gusto Setup panel opens. Once setup is complete, the button reads Manage.
- Open People if it is closed.
- For a member with a Suggested match, click Accept match.
- To choose someone else, click Change, then click Link beside the Gusto person.
- To leave the suggestion for now, click Skip. It lasts until you close Gusto Setup.
- For a member marked Not linked, click Link person, then click Link beside the Gusto person.
- A search box appears above the list when more than six Gusto people can be chosen.
- For a linked member with more than one Gusto job, choose the job in Gusto job.
The member's row shows the Gusto name. The People summary shows how many members are linked out of the total.
Note
Linking queues the member's approved time since the sync start date for sending, and copies their Gusto pay into JobWise Pro (src/lib/server/integrations/gusto/people.ts:270-279).
Each Gusto person links to one member only (src/lib/server/integrations/gusto/people.ts:294-307). Gusto people marked terminated or inactive are flagged on the member's row, and the member must be relinked before their hours are sent (src/lib/components/gusto/setup.ts:34-48).
Sync now at the top of Gusto Setup refreshes linked members' names and pay, and the time off policies (src/lib/components/GustoSetupPanel.svelte:97-108; src/lib/server/integrations/gusto/people.ts:365-368).
Link time off policies
Hours from a paid policy reach Gusto only when the policy is linked to a Gusto policy. An unpaid policy needs no link (src/lib/components/gusto/GustoTimeOffSection.svelte:152-155).
- Open Time Off in Gusto Setup.
- For an active Gusto policy marked Not linked, click Sync now. The sync links a matching JobWise Pro policy or creates one.
- Under Paid Policies Not in Gusto, open Link to Gusto policy and choose a policy, or click Make unpaid.
- For each person under Not enrolled in Gusto, click Add to policy.
- The button stays off until the policy is linked and the person has a Gusto job. Add the job in Gusto, then click Sync now.
The enrolled person leaves the Not enrolled in Gusto list.
Match the workweek
Weekly overtime uses the workweek start day set in JobWise Pro. This section compares it with the start day of each active Gusto pay schedule.
- Open Workweek in Gusto Setup.
- On a Gusto workweek row with a different start day, click Use Gusto's workweek.
The Workweek status changes to Done.
Each Gusto workweek row shows one pay schedule's start day, and Use Gusto's workweek copies it to JobWise Pro (src/lib/components/gusto/GustoWorkweekSection.svelte:17-46). To set the day without Gusto, use time tracking settings.
Choose automatic sending and the sync start date
Automatic Sending sends approved hours to Gusto before each payroll deadline. The sync start date sets the earliest work date that is sent.
- Open Automatic Sending in Gusto Setup.
- Turn the toggle at the top of the section on or off.
- In Sync start date, choose a date, then click Save date.
With the toggle on, each payroll is sent once its deadline is within 24 hours (src/lib/server/integrations/gusto/handoff-runner.ts:492-533). Send Hours to Gusto covers what is sent.
Only approved time on or after the sync start date is sent. Earlier time stays in JobWise Pro (src/lib/components/gusto/GustoSendingSection.svelte:75-77). The automatic sending setting defaults to on (supabase/schemas/gusto.sql:39).
Disconnect Gusto
Disconnecting ends syncing with Gusto. Start from the Gusto row.
- In the Gusto row, open Gusto options.
- Click Disconnect.
The Gusto row offers Connect Gusto again.
Warning
Disconnecting removes every member link, the sync start date, and the automatic sending setting. Pay fields that Gusto set become editable again (src/lib/functions/integrations.remote.ts:127-137).
If the row asks for your sign-in to Gusto again, it shows Reconnect in place of Set up or Manage. Nothing syncs until you reconnect (src/routes/dashboard/[id]/settings/integrations/+page.svelte:173-174, 685).
What Gusto manages after linking
Once a member or policy is linked, Gusto owns the fields below. Change them in Gusto, then click Sync now in Gusto Setup.
- Hourly rate: for a member paid by the hour, the field is read-only and marked Managed in Gusto. JobWise Pro refuses rate changes (src/lib/components/time/TimeSettingsBody.svelte:933-937; src/lib/server/integrations/gusto/locks.ts:18-57).
- Members paid per paycheck, and fixed-wage contractors, keep an editable rate, because Gusto supplies no hourly rate for them (src/lib/components/time/TimeSettingsBody.svelte:940-943).
- Exempt from overtime: disabled for linked contractors, and for employees whose Gusto record has an FLSA status (src/lib/components/time/TimeSettingsBody.svelte:953-958; src/lib/server/integrations/gusto/locks.ts:49).
- Time off policies linked to Gusto open read-only. Their name, paid status, accrual, and active enrollment come from Gusto (src/lib/components/time/TimeSettingsBody.svelte:987-988).
- Balance from Gusto: each balance shows Managed in Gusto in place of Paid or Unpaid, with the last sync time. Approved requests that Gusto has not yet paid are already deducted (src/lib/components/time/TimeOffBody.svelte:289-305).
- Requests approved in Gusto are read-only in JobWise Pro. They show Requested in Gusto under the policy name. You cannot edit, cancel, or review them in JobWise Pro, and JobWise Pro does not add their hours to payroll again. Edit or cancel them in Gusto (src/lib/components/time/TimeOffBody.svelte:386-389, 498-503; src/lib/server/integrations/gusto/locks.ts:97-102). See Request Time Off.
Related Guides
- Send Approved Hours to Gusto Send approved hours, time off, and holiday pay to Gusto, fix what blocks a send, and track its progress.
- Configure Time Tracking Settings Set pay, overtime, breaks, time off, and holidays so tracked hours pay out correctly.
- Introduction to Time Tracking Find where clocking, timesheets, time off, availability, and payroll live, and which of them your role can open.
Still Need Help?
If an article did not cover it, send us a message and a real person will get back to you.