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-05-13

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.