GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Create a webhook subscription

post
https://api.gusto-demo.com/v1/webhook_subscriptions

Create a webhook subscription to receive events of the specified subscription_types whenever there is a state change.

System Access Authentication

This endpoint uses the Bearer Auth scheme with the system-level access token in the HTTP Authorization header.

scope: webhook_subscriptions:write

Body Params
string
required
subscription_types
array of strings
required
subscription_types*
Headers
string
enum
Defaults to 2026-02-01

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Allowed:
Responses

404

Not Found

The requested resource does not exist. Make sure the provided UUID is valid.

Updated 5 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 months ago