> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

Webhooks allow you to receive notifications of events that occurred on the
platform. These notifications are delivered to an HTTPS endpoint
of your choice.

## Setup

Multiple webhook URLs per instance are supported. Webhooks can be configured
by administrators by heading to **Settings** -> **Manage Integrations** ->
**Webhook subscriptions**. For each subscription, it's possible to listen to
the events for all merchant accounts in an instance, or to the events for one
merchant account.

## Webhook delivery behavior

1. **Multiple subscriptions**\
   If you configure multiple subscriptions pointing to different URLs, each subscription receives its own webhook deliveries.
2. **Retries are subscription-specific**\
   If a webhook delivery fails, it is only retried for the subscription that encountered the failure, even if other subscriptions (pointing to the same or different URLs) succeed.

## Supported features

* Multiple webhook subscriptions per merchant account
* Merchant account and instance-level webhook subscriptions
* Detailed [payloads](./payload) for transactions, payment methods, buyers, billing details, and most other transaction related events.
* Over 20 different webhook [events](./events).
* Basic authentication credentials (username/password)
* OAuth authentication (password and credentials grant)
* Automatic retries of undelivered events
* Webhook [signatures](./signatures) to verify authenticity.

## Next steps

* Learn about the structure of webhook messages in [Payloads](./payload)
* Review all supported webhook [Events](./events)
* Understand delivery guarantees and retry logic in [Technical considerations](./technical-considerations)
* Secure your endpoints by verifying [Signatures](./signatures)