Gusto

Gusto is the payroll + benefits + HR system most US-based startups and small businesses default to. The integration treats Gusto as a live data source — employees, payroll, benefits, time off, all queryable from chat and writable from automations through the Gusto Embedded Payroll API.

What you can do

• Pull employee context into a chat — who reports to whom, employment status, hire date, recent time off, all queryable inline.
• Time-off awareness — automations can check who's out before scheduling or routing decisions.
• Payroll status visibility — current pay period state, upcoming runs, exceptions — without bouncing through the Gusto UI.
• Benefits-eligibility lookups for the workflows that need to know what coverage someone has.
• Write-back where appropriate — for the specific records where automation makes sense (new hire kickoff, status updates), not bulk payroll posting.

How to connect

OAuth 2.0 against the Gusto Embedded Payroll API. Sign in with your Gusto partner credentials; myai handles token exchange and refresh.

Two important quirks worth knowing:

• Access tokens expire after 2 hours (expires_in: 7200). myai handles refresh, but functions that hold connections for hours need to expect a refresh mid-run.
• Refresh tokens are single-use — every refresh issues a new one and revokes the previous. Two clients refreshing concurrently means one ends up with a dead token. myai's refresh is serialized to avoid this, but custom integrations against Gusto need the same care.
• API version header required: X-Gusto-API-Version: 2026-02-01. Gusto versions monthly when breaking changes ship; check your Developer Portal default quarterly.

Connect Gusto in myai

Common use cases

• New-hire onboarding automation — Gusto record created, function provisions accounts in connected tools and pings the manager.
• PTO-aware scheduling — automation checks Gusto before assigning work, doesn't route to people who are out.
• People-ops reporting — headcount trends, time-off patterns, turnover metrics surfaced alongside business metrics in a single canvas.

Reference

• Connection model: Gusto Embedded Payroll OAuth 2.0
• Token lifecycle: 2-hour access tokens, single-use refresh tokens
• Required header: X-Gusto-API-Version: 2026-02-01 (update quarterly)
• Scope: ~40 operations across employees, payroll, benefits, time off, company config