> For the complete documentation index, see [llms.txt](https://docs.getblock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getblock.io/webhooks.md).

# Webhooks

- [Overview](https://docs.getblock.io/webhooks/overview.md): GetBlock Webhooks send signed HTTPS POST notifications to your endpoint when on-chain events you care about happen on Ethereum: address activity, contract logs and transaction confirmations.
- [Getting Started](https://docs.getblock.io/webhooks/getting-started.md): Create your first GetBlock webhook in the dashboard or through the API, save its signing secret, send a test event and verify it on your endpoint.
- [Triggers and Filters](https://docs.getblock.io/webhooks/triggers-and-filters.md): What fires a GetBlock webhook delivery: the three triggers, the unconfirmed and confirmed phases, the filter tree, and named address lists.
- [Delivery Format](https://docs.getblock.io/webhooks/delivery-format.md): The HTTPS request a GetBlock webhook sends to your endpoint: headers, response rules, payload fields, example events and test deliveries.
- [Verifying Signatures](https://docs.getblock.io/webhooks/verifying-signatures.md): Verify the X-GetBlock-Signature header of every webhook delivery, with ready-to-use Go, JavaScript and Python recipes, a published test vector and the secret rotation procedure.
- [Handling Chain Reorganizations](https://docs.getblock.io/webhooks/handling-chain-reorganizations.md): GetBlock webhooks deliver at least once and send reorg corrections. How to de-duplicate deliveries and undo events whose block left the chain.
- [Retries and Endpoint Protection](https://docs.getblock.io/webhooks/retries-and-endpoint-protection.md): How GetBlock webhooks treat your endpoint's answers: the retry schedule, concurrency and rate limits, the circuit breaker, auto-pause, target URL rules, delivery source addresses and the delivery hist
- [Pricing and Limits](https://docs.getblock.io/webhooks/pricing-and-limits.md): What GetBlock webhooks cost in CU, the statuses a webhook can be in, what happens when the CU balance runs out, and the webhook limits of each plan.
- [API Reference](https://docs.getblock.io/webhooks/api-reference.md): Full reference for the GetBlock Webhooks API: base URL, authentication, every webhook and address-list endpoint, pagination, limits, and error codes.
- [Objects and Conventions](https://docs.getblock.io/webhooks/api-reference/objects-and-conventions.md): The webhook and address list objects, pagination, request rules, and limits shared by every endpoint of the GetBlock Webhooks API.
- [Error Codes](https://docs.getblock.io/webhooks/api-reference/error-codes.md): Every error code the GetBlock Webhooks API returns, with its HTTP status and when it happens.
- [Create webhook - Webhooks](https://docs.getblock.io/webhooks/api-reference/create-webhook.md): Create a webhook that sends matching Ethereum events to your endpoint. Complete guide on how to use POST /webhooks in GetBlock Webhooks documentation.
- [List webhooks - Webhooks](https://docs.getblock.io/webhooks/api-reference/list-webhooks.md): List your webhooks, newest first, one page at a time. Complete guide on how to use GET /webhooks in GetBlock Webhooks documentation.
- [Get webhook limits - Webhooks](https://docs.getblock.io/webhooks/api-reference/get-webhook-limits.md): Get your plan's webhook limits and current address usage. Complete guide on how to use GET /webhooks/limits in GetBlock Webhooks documentation.
- [Get webhook - Webhooks](https://docs.getblock.io/webhooks/api-reference/get-webhook.md): Get one of your webhooks by id. Complete guide on how to use GET /webhooks/{id} in GetBlock Webhooks documentation.
- [Update webhook - Webhooks](https://docs.getblock.io/webhooks/api-reference/update-webhook.md): Change some of a webhook's settings: endpoint, phases, filter, addresses or name. Complete guide on how to use PATCH /webhooks/{id} in GetBlock Webhooks documentation.
- [Delete webhook - Webhooks](https://docs.getblock.io/webhooks/api-reference/delete-webhook.md): Delete a webhook and free its plan slot. Complete guide on how to use DELETE /webhooks/{id} in GetBlock Webhooks documentation.
- [Pause webhook - Webhooks](https://docs.getblock.io/webhooks/api-reference/pause-webhook.md): Stop a webhook's deliveries until you resume it. Complete guide on how to use POST /webhooks/{id}/pause in GetBlock Webhooks documentation.
- [Resume webhook - Webhooks](https://docs.getblock.io/webhooks/api-reference/resume-webhook.md): Make a paused webhook active again. Complete guide on how to use POST /webhooks/{id}/resume in GetBlock Webhooks documentation.
- [Rotate webhook secret - Webhooks](https://docs.getblock.io/webhooks/api-reference/rotate-webhook-secret.md): Issue a new signing secret for a webhook, with or without a 24-hour overlap. Complete guide on how to use POST /webhooks/{id}/secret/rotate in GetBlock Webhooks documentation.
- [Send test event - Webhooks](https://docs.getblock.io/webhooks/api-reference/send-test-event.md): Send a free, signed test event to a webhook's endpoint. Complete guide on how to use POST /webhooks/{id}/test in GetBlock Webhooks documentation.
- [Get webhook deliveries - Webhooks](https://docs.getblock.io/webhooks/api-reference/get-webhook-deliveries.md): List a webhook's failed delivery attempts, newest first. Complete guide on how to use GET /webhooks/{id}/deliveries in GetBlock Webhooks documentation.
- [Get webhook stats - Webhooks](https://docs.getblock.io/webhooks/api-reference/get-webhook-stats.md): Get a webhook's delivery totals and recent delivery rates. Complete guide on how to use GET /webhooks/{id}/stats in GetBlock Webhooks documentation.
- [Get webhook addresses - Webhooks](https://docs.getblock.io/webhooks/api-reference/get-webhook-addresses.md): Read the addresses a webhook was given in its addresses field. Complete guide on how to use GET /webhooks/{id}/addresses in GetBlock Webhooks documentation.
- [Create address list - Webhooks](https://docs.getblock.io/webhooks/api-reference/create-address-list.md): Create a named address list that several webhooks can reference. Complete guide on how to use POST /address-lists in GetBlock Webhooks documentation.
- [List address lists - Webhooks](https://docs.getblock.io/webhooks/api-reference/list-address-lists.md): List your named address lists, newest first. Complete guide on how to use GET /address-lists in GetBlock Webhooks documentation.
- [Get address list - Webhooks](https://docs.getblock.io/webhooks/api-reference/get-address-list.md): Get one of your address lists by id, without its addresses. Complete guide on how to use GET /address-lists/{id} in GetBlock Webhooks documentation.
- [Rename address list - Webhooks](https://docs.getblock.io/webhooks/api-reference/rename-address-list.md): Rename one of your address lists. Complete guide on how to use PATCH /address-lists/{id} in GetBlock Webhooks documentation.
- [Delete address list - Webhooks](https://docs.getblock.io/webhooks/api-reference/delete-address-list.md): Delete one of your address lists. Complete guide on how to use DELETE /address-lists/{id} in GetBlock Webhooks documentation.
- [Get address list entries - Webhooks](https://docs.getblock.io/webhooks/api-reference/get-address-list-entries.md): Read the addresses in one of your address lists. Complete guide on how to use GET /address-lists/{id}/entries in GetBlock Webhooks documentation.
- [Add address list entries - Webhooks](https://docs.getblock.io/webhooks/api-reference/add-address-list-entries.md): Add addresses to one of your address lists. Complete guide on how to use POST /address-lists/{id}/entries in GetBlock Webhooks documentation.
- [Replace address list entries - Webhooks](https://docs.getblock.io/webhooks/api-reference/replace-address-list-entries.md): Replace all addresses in one of your address lists. Complete guide on how to use PUT /address-lists/{id}/entries in GetBlock Webhooks documentation.
- [Remove address list entries - Webhooks](https://docs.getblock.io/webhooks/api-reference/remove-address-list-entries.md): Remove addresses from one of your address lists. Complete guide on how to use POST /address-lists/{id}/entries/remove in GetBlock Webhooks documentation.