thirdwebDocs
GitHub

Managing Webhooks

For most up to date technical spec refer to https://insight-api.thirdweb.com/reference#tag/webhooks.

List Webhooks

GET /v1/webhooks

Retrieve all webhooks for your project or get details for a specific webhook by ID.

Create Webhook

POST /v1/webhooks

Creates a new webhook subscription.
It may take up to a minute to start working.

Update Webhook

PATCH /v1/webhooks/:webhook_id

You can modify the URL or filters of a webhook. Additionally you can enable and disable the webhook.
Changes may take up to a minute to take effect.

Delete Webhook

DELETE /v1/webhooks/:webhook_id

Permanently removes a webhook subscription. This action cannot be undone.

Test Webhook

POST /v1/webhooks/test

Sends a sample payload signed with a test secret ('test123').
Useful for testing your receiver endpoint before creating actual webhooks.