---
title: "Verify a webhook subscription"
method: PUT
path: "/v1/webhook_subscriptions/{webhook_subscription_uuid}/verify"
tags: ["Webhooks"]
---

# Verify a webhook subscription

`PUT /v1/webhook_subscriptions/{webhook_subscription_uuid}/verify`

When a webhook subscription is created, a `verification_token` is POSTed to the registered webhook subscription URL. This `verify` endpoint needs to be called with `verification_token` before webhook events can be sent to the registered webhook URL.

Use the /v1/webhook_subscriptions/{webhook_subscription_uuid}/request_verification_token API to resend the `verification_token` to the Subscriber.

📘 System Access Authentication

This endpoint uses the [Bearer Auth scheme with the system-level access token in the HTTP Authorization header](https://docs.gusto.com/embedded-payroll/docs/system-access)

scope: `webhook_subscriptions:write`

## Path parameters

- `webhook_subscription_uuid` string, required

## Headers

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

## Request body

- object
  - `verification_token` string, required — The verification token received at the webhook subscription URL.

## Response `200`

successful

- WebhookSubscription — The representation of webhook subscription.
  - `uuid` string, required — The UUID of the webhook subscription.
  - `url` string — The webhook subscriber URL. Updates will be POSTed to this URL.
  - `status` 'pending' | 'verified' | 'removed' | 'unreachable' — The status of the webhook subscription.
  - `subscription_types` string[] — Receive updates for these types.

## Other responses

- `404` — Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422` — Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[API](https://skmtc.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)