Verify Webhook

Verify a webhook endpoint URL.

Sends a verification challenge to the webhook's URL. Your endpoint must respond with the correct challenge value to pass verification. Webhooks must be verified before they receive events.

Use Cases

  • Complete the webhook setup process after creating a subscription.
  • Re-verify a webhook after changing its URL.

How it works

The API sends an HTTP POST to your webhook URL with a challenge payload. Your endpoint must respond with 200 OK and echo the challenge value. If verification succeeds, the webhook's verified flag is set to true.

Required scope: webhooks:write