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

# Webhooks

> Configure Meld Dashboard webhooks to receive transaction and customer lifecycle events.

## Overview

Configure webhooks directly in [Meld Dashboard](https://dashboard.meld.io/).

For event types and payload shapes, see [Meld's webhook events](https://docs.meld.io/docs/webhook-events). For signature verification, see [Meld's webhook authentication guide](https://docs.meld.io/docs/webhooks-authentication).

## 1. Add your endpoint in Meld Dashboard

In [Meld Dashboard](https://dashboard.meld.io/) (sandbox or production):

* Go to **Developer → Webhooks → Add endpoint**.
* Enter your HTTPS URL and subscribe to the events you care about (transaction lifecycle, KYC, etc.).
* Save — Meld generates a signing secret for the endpoint that you'll need in the next step.

## 2. Verify webhook signatures

Meld signs every delivery with the endpoint's secret. Copy the secret from the endpoint you just created, store it securely, and verify the signature on every inbound request — see [Meld's webhook authentication guide](https://docs.meld.io/docs/webhooks-authentication) for the formula and sample code.

## 3. Verify delivery

* Send a test event from Meld Dashboard.
* Confirm your endpoint returns `2XX`.
* Process events asynchronously after acknowledgment.

<Tip>
  Acknowledge webhook deliveries quickly with `2XX`, then process events asynchronously after signature verification.
</Tip>