# Webhooks

### What is a Webhook?

At Youverify, webhooks are a very important part of our reporting process. We use webhooks to communicate with different services. These are our identity and address services. 

Webhooks get pushed when the address or identity has been completed.

Please follow the following steps to have access to it;

▪ Set your webhook from the YVOS web portal(If already set, ignore the next step).

▪ Login to the YVOS portal-->Go to settings -> API KEY/Webhook. Scroll to " Webhook" and set your HTTP callback URL.

### Verifying Events

It is of great importance to verify that an event originated from Youverify to avoid delivering value based on a fictitious event.\
\
**Validate the Signature** - Valid events are raised with a header <mark style="color:red;">x-youverify-signature</mark> which is essentially a <mark style="color:red;">HMAC SHA256</mark> signature of the event payload signed using your secret key.

### Status Reports

#### Pending:

The status report “PENDING” for our Identity services is displayed when our upstream identity providers are unavailable.&#x20;

This status enables us to manage the upstream provider's downtime. To get the completed result for verification with a “PENDING” status, you will have to listen to the webhook to retrieve the completed verification and the corresponding response. The sample below shows when an identity verification request with a “PENDING” status.

**NB: Please note that the above symbol " | " is used to differentiate the possible outcomes.**

### [<br>](https://docs.youverify.co/docs/stoplightdoc/ZG9jOjE4OTc3OQ-youverify-documentation#error-codes) <a href="#error-codes" id="error-codes"></a>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.youverify.co/webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.