Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Webhooks

List webhook subscriptions

Returns all webhook subscriptions associated with the provided Partner API token.

📘 System Access Authentication

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

scope: webhook_subscriptions:read

get/v1/webhook_subscriptions

Headers

X-Gusto-API-Version'2026-06-15'

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

Response

successful

uuidstring required

The UUID of the webhook subscription.

urlstring

The webhook subscriber URL. Updates will be POSTed to this URL.

status'pending' | 'verified' | 'removed' | 'unreachable'

The status of the webhook subscription.

subscription_typesstring[]

Receive updates for these types.