GuidesAPI ReferenceChangelogAPI PolicyGusto Security
Guides
These docs are for v2024-03-01. Click to read the latest docs for v2025-06-15.

Webhook Events

The Webhook Event Object

Field nameValue typeDescription
event_typestringDescription of the event (e.g., payroll.submitted, or company.form.signed).
resource_typestringName of the parent resource of the described entity (e.g., Company, or AccountingFirm).
resource_uuidstringUnique identifier for the parent.
entity_typestringName of the entity that the event corresponds to.
entity_uuidstringUnique identifier for the entity.
timestampnumberTime at which this event was created. Measured in seconds since the Unix epoch.
referencesobjectObject containing related identifiers associated with the event.

List of Webhook Events

Subscription type

Events

BankAccount

created
updated
deleted

Company

provisioned
deprovisioned
partner_authorized
migrated
updated
onboarded
approved
needs_approval
suspended
unsuspended

CompanyBenefit

created
updated
deleted

Contractor

created
updated
onboarded
deactivated
reactivated
deleted

ContractorPayment

created
cancelled

ContractorPaymentGroup

created
cancelled

Document

created
updated
signed

Employee

created
updated
onboarded
marked_for_self_onboarding
terminated
rehired
deleted

HomeAddress

created
updated
deleted

WorkAddress

created
updated
deleted

EmployeeBenefit

created
updated
deleted

EmployeeJobCompensation

created
updated
deleted

ExternalPayroll

created
updated
deleted

FastAchConfig

activated
deactivated

Form

created
updated
signed

GeneratedDocument

generated
failed

Location

created
updated

Notifications

created
resolved
updated

Payroll

created
updated
calculated
submitted
processed
paid
reversed
partially_reversed
cancelled
processing_failed

PaySchedule

created
updated

Signatory

created
updated
deleted
marked_for_invite