Skip to main content

Gusto

It also accepts webhooks from Gusto.

Connection

Saving the settings sends you to Gusto to approve your application’s access.

Setup

Klef connects to Gusto as an application you own. Creating one takes a Gusto developer account, and reading your real company takes Gusto’s approval of that application.
1
In the Gusto developer portal, create an application.
2
Add https://klef.ai/api/connections/gusto/callback to the application’s redirect URIs.
3
Give the application the companies:read, employees:read, jobs:read, employments:read, contractors:read, and time_off_requests:read scopes.
4
Enter the application’s client ID and secret in the connection’s settings, turn on Demo environment, and click the Connect button. Gusto then asks you to approve the application.
5
Once Gusto approves the application for production, enter the production client ID and secret, turn off Demo environment, and click the Save button.
Until Gusto approves it, an application can only read companies in Gusto’s demo environment. Gusto reviews each application and decides whether to approve it.
If you leave Gusto without approving the application, open the connection and click the Authorize button.

Apply terminations as they happen

Klef can apply a termination as soon as Gusto processes it, rather than waiting for the next plan. This needs the Standard or Enterprise plan.
1
Open the Gusto connection in Klef and copy its Webhook URL.
2
In the Gusto developer portal, open your application’s Webhook subscriptions tab and add a subscription with that URL and the Employee and Contractor subscription types. Gusto sends Klef a verification token, which Klef keeps.
3
In Klef, open the Gusto connection, reveal its Webhook verification token, and enter it in Gusto to verify the subscription.
4
In Klef’s workspace settings, turn on Apply HR webhook events automatically.
Klef acts on employee.terminated, employee.termination_effective, employee.termination_cancelled, employee.deleted, contractor.deactivated, contractor.deactivation_effective, contractor.deactivation_cancelled, and contractor.deleted, and ignores Gusto’s other events. For each, Klef reads that person again from Gusto and applies only their termination, without approval, once it has taken effect. Gusto reports a termination or a contractor’s dismissal as effective the day after the person’s last day. A plan still catches anything a webhook missed.

Settings

Fields

The worker model fields Klef fills from Gusto.