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

# Webhook

> Send real-time verification updates to your system from Trust Flow Settings.

The **Webhook** section in Trust Flow Settings lets you send real-time updates to your system when verification events happen.

After you [create a Trust Flow](/trust-flows/creating-a-trust-flow), open **Trust Flow Settings** and go to **Webhook**.

## Verification Webhook

Enable this toggle to receive webhook notifications whenever a verification is completed.

When **Verification Webhook** is enabled, enter these fields:

* **Webhook URL** — The endpoint URL where IDmeta sends verification completion events.
* **Webhook Secret** — A secret used to validate that webhook requests come from IDmeta.

<img src="https://mintcdn.com/idmeta/PI9V8W-pSMpLIycU/images/trust-flow-webhook-settings.png?fit=max&auto=format&n=PI9V8W-pSMpLIycU&q=85&s=637152afd0f6463e2285ccff1e868318" alt="Verification Webhook enabled with Webhook URL and Webhook Secret in Trust Flow Settings" width="1024" height="536" data-path="images/trust-flow-webhook-settings.png" />

After you enter the details, click **Save Settings** to apply the webhook configuration.

## Webhook secret in the received request

After a verification is completed, IDmeta sends a webhook request to your **Webhook URL**. The **Webhook Secret** you entered in Trust Flow Settings is included in the request header as `x-webhook-secret`.

For example, if you set **Webhook Secret** to `123456`, the received request includes:

`x-webhook-secret: 123456`

<img src="https://mintcdn.com/idmeta/PI9V8W-pSMpLIycU/images/trust-flow-webhook-secret-header.png?fit=max&auto=format&n=PI9V8W-pSMpLIycU&q=85&s=45959ea74f425f9b5b0e48cb57e52cfd" alt="Received webhook request showing x-webhook-secret header" width="1024" height="256" data-path="images/trust-flow-webhook-secret-header.png" />

Use this header to confirm that the webhook request was sent by IDmeta.

## Webhook payload

When a Trust Flow verification finishes, IDmeta sends a `POST` request with a JSON body. The event type is `trustValidation.complete`.

The payload includes verification outcome fields such as `success`, `trustValidationStatus`, `trustFlowId`, `trustValidationId`, and a `data` object with details like `profileName`, `timeToVerify`, and `processedVerifications`.

<img src="https://mintcdn.com/idmeta/PI9V8W-pSMpLIycU/images/trust-flow-webhook-payload.png?fit=max&auto=format&n=PI9V8W-pSMpLIycU&q=85&s=a2ef4c1e92c70f6650d600071a7df255" alt="Webhook.site request body showing trustValidation.complete payload" width="1024" height="441" data-path="images/trust-flow-webhook-payload.png" />

You can also review the related verification result in the API Reference. For example, when Document Verification runs in the Trust Flow, the Document Verification response includes extracted fields such as name and address.

<img src="https://mintcdn.com/idmeta/PI9V8W-pSMpLIycU/images/trust-flow-webhook-api-reference-result.png?fit=max&auto=format&n=PI9V8W-pSMpLIycU&q=85&s=d59bbf65dc7a88a5b283dbab1bbddc1d" alt="Document Verification response in the API Reference" width="1024" height="509" data-path="images/trust-flow-webhook-api-reference-result.png" />

For related Trust Flow setup, see [Trust Flow Settings](/trust-flows/trust-flow-settings). For a full setup walkthrough, see [Adding webhooks to a Trust Flow](/developer-tools/adding-webhooks-to-trust-flow).