# Webhooks

## Webhook Events

Webhook allows your system to receive real-time event notifications. To create a Webhook, go to your Portal. From the **Main Menu**, navigate to **Operations** > **Webhook** and click on **Add Webhook**.\
\
Here is a list of webhook event types along with their event ID and information:

<table><thead><tr><th>Event Type</th><th width="137">Event ID</th><th>Description</th></tr></thead><tbody><tr><td>CREATE ACCOUNT</td><td>1</td><td>A notification to alert you when a customer account (Savings or Current) is created.</td></tr><tr><td>UPDATE ACCOUNT</td><td>2</td><td>A notification to alert you when a customer account (Savings or Current) is updated.</td></tr><tr><td>CREATE CUSTOMER</td><td>3</td><td>A notification to alert you when a customer (Individual, Group or Organisation) is created.</td></tr><tr><td>UPDATE CUSTOMER</td><td>4</td><td>A notification to alert you when a customer (Individual, Group or Organisation) is updated.</td></tr><tr><td>TRANSACTION SUCCESSFUL</td><td>5</td><td>A notification to alert you when a transaction is successful.</td></tr><tr><td>TRANSACTION REVERSED</td><td>6</td><td>A notification to alert you when a transaction is reversed.</td></tr></tbody></table>

## Webhook Fault Tolerance

When sending a POST request to your webhook URL, we will make five retry attempts if we do not receive a 2XX response code. The retry time will follow an exponential back-off pattern, starting with 2 seconds and doubling after each attempt (2² times). If the maximum number of attempts is reached and the request fails, it will be logged and can be retried manually on the portal.&#x20;

We advise using the entity's ID to check for duplicates in your system to ensure proper event handling. For secure communication, using HTTPS for all interactions is highly recommended.<br>

{% hint style="info" %}
Authenticated calls are supported. We accept a Basic Authentication Type in which you supply a Username and Password for Authorisation.
{% endhint %}