---
title: "Request a verification token for a webhook subscription"
method: GET
path: "/v1/webhook_subscriptions/{webhook_subscription_uuid}/request_verification_token"
tags: ["Webhooks"]
---

# Request a verification token for a webhook subscription

`GET /v1/webhook_subscriptions/{webhook_subscription_uuid}/request_verification_token`

Request that the webhook subscription `verification_token` be POSTed to the Subscription URL.

📘 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:read`

## Path parameters

- `webhook_subscription_uuid` string, required

## Headers

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

## Response `200`

No Content. The `verification_token` is POSTed to the Subscription URL.

- WebhookVerificationTokenResponse — The response from requesting a webhook subscription verification token.
  - `message` string — A message indicating the verification token has been sent.

## Other responses

- `404` — Not Found The requested resource does not exist. Make sure the provided UUID is valid.

---

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