AutomateLab

SaaS webhooks / HRIS

Gusto webhook events.

16 events emitted by Gusto in the team-ops webhook catalog. Each event below carries the canonical event name, payload schema (field names and types only), auth method, signature header, retry policy, and a link back to Gusto's docs.

Auth mix: 16 hmac-sha256 · Source extraction: 2026-10-12

v1 verification gap

Tier-2 LLM-assisted; ~82% spot-check accuracy. Event names may drift from Gusto's current canonical names. Planned re-extraction in v1.1.

All 16 events

Direct anchors. Each event header links to its own URL.

company.created

A new company is provisioned via the Embedded API.

namespace: company / extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: company.created.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Company.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Company at the time of the event.
uuid string required
Company UUID.
name string
ein string | null
Employer Identification Number.
entity_type string | null
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

company.migration_completed

A company migration to the embedded platform is completed.

namespace: company / extraction: llm assisted (confidence 0.75)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: company.migration_completed.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Company.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Company at the time of the event.
uuid string required
Company UUID.
name string
ein string | null
Employer Identification Number.
entity_type string | null
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

company.updated

A company's configuration or details are updated.

namespace: company / extraction: llm assisted (confidence 0.80)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: company.updated.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Company.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Company at the time of the event.
uuid string required
Company UUID.
name string
ein string | null
Employer Identification Number.
entity_type string | null
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

contractor.created

A new contractor (individual or business) is added to the company.

namespace: contractor / extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: contractor.created.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Contractor.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Contractor at the time of the event.
uuid string required
company_uuid string required
type string (enum)
first_name string | null
last_name string | null
business_name string | null
email string | null
start_date string | null
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

contractor.updated

A contractor's information is updated.

namespace: contractor / extraction: llm assisted (confidence 0.80)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: contractor.updated.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Contractor.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Contractor at the time of the event.
uuid string required
company_uuid string
type string (enum)
first_name string | null
last_name string | null
business_name string | null
email string | null
start_date string | null
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

employee.created

A new employee is created in the company.

namespace: employee / extraction: llm assisted (confidence 0.90)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: employee.created.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Employee.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Employee at the time of the event.
uuid string required
Employee UUID.
first_name string
last_name string
email string | null
company_uuid string required
onboarding_status string | null
start_date string | null
termination_date string | null
is_terminated boolean
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

employee.onboarded

An employee completes onboarding.

namespace: employee / extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: employee.onboarded.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Employee.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Employee at the time of the event.
uuid string required
Employee UUID.
first_name string
last_name string
email string | null
company_uuid string
onboarding_status string | null
start_date string | null
termination_date string | null
is_terminated boolean
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

employee.terminated

An employee is marked as terminated in the system.

namespace: employee / extraction: llm assisted (confidence 0.90)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: employee.terminated.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Employee.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Employee at the time of the event.
uuid string required
Employee UUID.
first_name string
last_name string
email string | null
company_uuid string
onboarding_status string | null
start_date string | null
termination_date string | null
is_terminated boolean required
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

employee.termination_cancelled

A previously submitted employee termination is cancelled.

namespace: employee / extraction: llm assisted (confidence 0.80)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: employee.termination_cancelled.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Employee.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Employee at the time of the event.
uuid string required
Employee UUID.
first_name string
last_name string
email string | null
company_uuid string
onboarding_status string | null
start_date string | null
termination_date string | null
is_terminated boolean
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

employee.updated

An employee's profile or information is updated.

namespace: employee / extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: employee.updated.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Employee.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Employee at the time of the event.
uuid string required
Employee UUID.
first_name string
last_name string
email string | null
company_uuid string
onboarding_status string | null
start_date string | null
termination_date string | null
is_terminated boolean
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

form_i9.created

A Form I-9 employment eligibility verification is created for an employee.

namespace: form_i9 / extraction: llm assisted (confidence 0.75)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: form_i9.created.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: FormI9.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the FormI9 at the time of the event.
uuid string required
employee_uuid string required
company_uuid string
status string
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

form_i9.updated

A Form I-9's status or details are updated.

namespace: form_i9 / extraction: llm assisted (confidence 0.70)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: form_i9.updated.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: FormI9.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the FormI9 at the time of the event.
uuid string required
employee_uuid string
status string
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

payroll.cancelled

A payroll run is cancelled before it is processed.

namespace: payroll / extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: payroll.cancelled.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Payroll.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Payroll at the time of the event.
uuid string required
company_uuid string
pay_period object
Pay period covered by this payroll run.
start_date string
end_date string
pay_schedule_uuid string
check_date string | null
Date checks are issued.
processed boolean
Whether this payroll has been processed.
totals object | null
Payroll total amounts.
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

payroll.created

A new payroll run is created for a pay period.

namespace: payroll / extraction: llm assisted (confidence 0.85)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: payroll.created.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Payroll.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Payroll at the time of the event.
uuid string required
company_uuid string required
pay_period object
Pay period covered by this payroll run.
start_date string
end_date string
pay_schedule_uuid string
check_date string | null
Date checks are issued.
processed boolean
Whether this payroll has been processed.
totals object | null
Payroll total amounts.
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

payroll.submitted

A payroll run is submitted for processing.

namespace: payroll / extraction: llm assisted (confidence 0.90)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: payroll.submitted.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Payroll.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Payroll at the time of the event.
uuid string required
company_uuid string
pay_period object
Pay period covered by this payroll run.
start_date string
end_date string
pay_schedule_uuid string
check_date string | null
Date checks are issued.
processed boolean required
Whether this payroll has been processed.
totals object | null
Payroll total amounts.
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

payroll.updated

A payroll run's data is changed before processing.

namespace: payroll / extraction: llm assisted (confidence 0.80)

Auth

Auth method
hmac-sha256
Signature header
x-gusto-signature
Signature detail
HMAC-SHA256 of the raw request body using the webhook subscription's shared secret.
Idempotency header
x-gusto-event-uuid
Event ID header
x-gusto-event-uuid

Delivery

Guarantees
at-least-once
Backoff
Gusto retries failed webhook deliveries with exponential backoff.

Payload schema (field names + types only)

event_type string required
Event type: payroll.updated.
resource object required
Resource metadata.
uuid string required
UUID of the affected resource.
type string required
Resource type: Payroll.
url string
API URL of the resource.
entity_uuid string
UUID of the entity (company, etc.) that owns the resource.
timestamp string required
ISO 8601 timestamp when the event occurred.
entity_attributes object
Key attributes of the Payroll at the time of the event.
uuid string required
company_uuid string
pay_period object
Pay period covered by this payroll run.
start_date string
end_date string
pay_schedule_uuid string
check_date string | null
Date checks are issued.
processed boolean
Whether this payroll has been processed.
totals object | null
Payroll total amounts.
Notes: Gusto Embedded Payroll is the embedded platform product. Swapped into v1 from Rippling per operator decision 2026-05-13 (sub 1.2 ToS audit).

Vendor docs

Use this data programmatically

The full catalog ships as a HuggingFace dataset under CC-BY-4.0. Load it with the datasets library, filter by vendor, and you have every Gusto event in a Parquet table ready for code-generation, schema validation, or routing. 

from datasets import load_dataset
ds = load_dataset("automatelab/saas-webhook-catalog")
events = ds["train"].filter(lambda r: r["vendor"] == "gusto")

Open the dataset on HuggingFace Source on GitHub

Other vendors in the catalog

Back to the index for all 30 vendors.

Snapshot provenance

This snapshot was regenerated from static extractors on 2026-10-12. Generation is separate from vendor verification. Unknown source checks remain null; check the vendor documentation before implementing an event.