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

# Webhooks

> Guide on Bleeprs webhook event communications

In addition to email notification of transactions, webhook is a fast and cost-effective way to manage system-to-system communications. Below are the supported events that trigger a webhook on Bleeprs.

### Authentication

When you create a webhook URL on your dashboard, the system will generate a unique secret token. This token will be sent as a `X-Webhook-Token` header with each request. You should verify the token to ensure that the request is coming from Bleeprs.

### Events

<Tabs>
  <Tab title="Processing">
    📣 `event.processing` Is the first event you recieve for any message sent.

    ```json theme={null}
    {
      "event": "event.processing",
      "data": {
        "id": 23,
        "messageReference": "BLPRS_MG_****",
        "completed": false,
        "amount": "0.5",
        "currency": "USD"
      }
    }
    ```
  </Tab>

  <Tab title="Delivered">
    📣 `event.delivered` Is the next event if the message was delivered

    ```json theme={null}
    {
      "event": "event.delivered",
      "data": {
        "id": 23,
        "messageReference": "BLPRS_MG_****",
        "completed": true,
        "amount": "0.5",
        "currency": "USD"
      }
    }
    ```
  </Tab>

  <Tab title="Failed">
    📵 `event.failed` Is the next event if the message was delivery failed.
    Retry usually happens twice before the message is considered failed
    completely

    ```json theme={null}
    {
     "event": "event.failed",
     "data": {
       "id": 23,
       "messageReference": "BLPRS_MG_****",
       "completed": false,
       "amount": "0.5",
       "currency": "USD"
     }
    }
    ```
  </Tab>
</Tabs>

### Configure Webhook

To get webhook events and actions notifications, you are required to provide a webhook URL which these notifications will be sent. Follow the steps below to setup a webhook on your Pooler account:

Go to **profile/setting** and update the Webhook hook url

<Frame>
  <img src="https://mintcdn.com/bleeprs/BG4kit0okQ4pa133/images/webhook.png?fit=max&auto=format&n=BG4kit0okQ4pa133&q=85&s=dcf0fdb2c830b6f2a908740282aeefaf" width="1001" height="139" data-path="images/webhook.png" />
</Frame>

Enter your webhook URL and click on the Submit button.

<Info>
  Webhooks are very important for notifying you about the status of your
  delivery
</Info>

### Retry policy

If our attempt to deliver the POST request to your webhook URL fails with an HTTP response that is not `2XX`, we will retry the request up to **6 times** with a **60 second** delay between each attempt. With each subsequent failure, the wait time will double. If after all attempts the webhook is still not acknowledged, no further attempts will be made.