# Webhook Settings

A webhook is a real-time communication method used by applications to instantly share event-driven data.&#x20;

When a specific event occurs in one application, it sends a message, often in the form of an HTTP POST request, to a predefined URL in another application.&#x20;

This allows for immediate updates, automated actions, and seamless integration between different systems, enhancing efficiency and enabling timely responses based on events.&#x20;

#### **Accessing the Webhook Setting Tab**

1. In the sidebar of the interface, find and click on the **Settings** menu.
2. Within the Settings menu, click on the **Webhook Setting** tab on the left.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FCOsi9rzh5yZqPMCHsxfB%2Fw%201.png?alt=media&#x26;token=153e1990-ce14-4b0a-9618-1b38f2668c18" alt=""><figcaption></figcaption></figure>

**Accessing the Create Webhook View**

1. Go to the Admin Console.
2. Click on the **Settings -> Webhook Settings** tab on the left.
3. You'll find the **create Webhook** button on the right.

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FTZD1SCyXMnBWFbPNUmbP%2Fw%202.png?alt=media&#x26;token=aee00db7-a286-4e42-9ce7-d41ba0823d44" alt=""><figcaption></figcaption></figure>

**Setting Up a Webhook Endpoint from Another System's Configuration Interface**

1. Access the configuration interface of the system that will send webhook.
2. Use the configuration interface to specify the following:
   * The URL where data should be sent as part of the webhook.
   * The specific events or actions that should trigger the webhook.
   * Any authentication or security details required for the webhook to function securely.

<figure><img src="https://lh7-us.googleusercontent.com/uUTyIamP3amHRlTtihfgBR-zTAsAz4Apcfva5Od-PiNv-aCmxNj1JPt3kst9QY8Oxg1RGN7-io-Kw3DpCk90P_Fkphc-FP6wWa5j1V7TYNFRa2O61qviZeGXoncmreq8FundHCSWXp3_ccxf4GLTcNc" alt=""><figcaption></figcaption></figure>

**To Proceed or Cancel an Action**

1. Press the **Create** button to continue with the action.
2. Click **Cancel** if you wish to abort the process.

**Webhook Name**

* The name of the webhook you set up is crucial for identifying its purpose and function.&#x20;
* This name helps you easily recognize which webhook is responsible for handling specific events or tasks.&#x20;
* Choosing a descriptive and meaningful name for your webhook can streamline your workflow and organization.&#x20;

**Webhook Events**

* &#x20;Webhook events refer to the specific occurrences or triggers that prompt your webhook to send notifications or data to a designated endpoint.&#x20;
* These events can range from user actions, such as making a purchase or signing up, to system updates, like changes in data.&#x20;

**Notification Type**

* REST – It will notify the external system by the API&#x20;

**URL**

* The URL is the web address where your webhook sends its notifications or data.&#x20;
* It acts as the bridge between your webhook and the receiving application or system. &#x20;

**API Key**

* To provide an additional layer of security for your webhook's communication, an API key can be utilized.&#x20;
* An API key serves as a unique identifier and authentication token, allowing the receiving end to verify the legitimacy of incoming requests from your webhook.&#x20;

&#x20;

### Webhook Events

* Webhook events allow systems to communicate in real-time, reducing the need for constant polling or manual synchronization.&#x20;
* They play a crucial role in integrating and automating processes between different platforms and systems.&#x20;
* The types of webhook events you'll encounter depend on the applications you're using and the interactions you want to track or automate.&#x20;
* Webhook events are specific occurrences or actions that trigger the sending of data from one system (the webhook provider) to another system (the webhook receiver or listener).&#x20;
* These events are used to notify the receiver in real-time about changes or updates that have occurred in the provider system.&#x20;
* Webhook events vary depending on the context and the systems involved.&#x20;
* Here are some common examples of webhook events:

<figure><img src="https://lh7-us.googleusercontent.com/5XTExER_-X-KUk6S-SZt_Say1O189TyHgeVQPSXqx64hQTis5bTpNc24zpHrfguWC-0GfQON-tZh8Ff6mSC03alvvAttU5LqDjxi3OWlvSKT1m44cRE4GAn5YGPLPJn9t2a-JFDkYHKYbGHMoVOzmsY" alt=""><figcaption></figcaption></figure>

#### Webhook Request Body&#x20;

Webhook request body that contains the below.&#x20;

{ &#x20;

&#x20;   event\_time: Date; &#x20;

&#x20;   event\_type: string; &#x20;

&#x20;   current\_context: any; &#x20;

&#x20;   data: any; &#x20;

}&#x20;

A change in the event type will result in a corresponding adjustment to the data within the webhook event, ensuring that the conveyed information remains accurate for the specific event.&#x20;

**Available webhook events**

| **Events**                                     | **Description**                                                        |
| ---------------------------------------------- | ---------------------------------------------------------------------- |
| USER\_LOGIN                                    | when a user successfully logs into the system.                         |
| USER\_LOGIN\_FAILURE                           | when a user's login attempt fails.                                     |
| USER\_CREATED                                  | when a new user account is created.                                    |
| USER\_MODIFIED:                                | User account details are changed.                                      |
| USER\_DELETED                                  | User account is removed.                                               |
| USER\_ENABLED:                                 | Disabled user account is reactivated.                                  |
| USER\_DISABLED                                 | User account is deactivated.                                           |
| USER\_EMAIL\_VERIFIED                          | User's email is confirmed.                                             |
| USER\_MOBILE\_NO\_VERIFIED                     | Verifies a user's provided mobile phone number.                        |
| USER\_IDENTITY\_ADDED:                         | Extra identity, like a social media profile, to a user account.        |
| USER\_IDENTITY\_REMOVED                        | Linked identity is disconnected from account.                          |
| USER\_PASSWORD\_CHANGED                        | User updates their password.                                           |
| EMAIL\_CHANGED                                 | User changes their email address.                                      |
| USER\_PASSWORD\_RESET\_INITIATE:               | User starts password reset process.                                    |
| USER\_PASSWORD\_RESET:                         | User successfully resets password.                                     |
| USER\_BLOCKED                                  | User's account is temporarily blocked.                                 |
| COMBINEDLOGOUTTOKEN\_CHECKED                   | Verification of special code for secure logouts                        |
| TOKEN\_RENEWEDCODE\_OBTAINED:                  | Code to renew permission is acquired.                                  |
| ACCESS\_TOKEN\_OBTAINED:                       | Permission to use something is obtained.                               |
| APP\_CREATEDAPP\_MODIFIED:                     | New app is made, or an existing app is changed.                        |
| APP\_DELETED:                                  | App is removed.                                                        |
| ROLE\_CREATEDROLE\_UPDATED:                    | New user role is made, or existing role is changed.                    |
| ROLE\_DELETED                                  | User role is removed.                                                  |
| PERMISSION\_CREATED                            | New permission is given to the user.                                   |
| PERMISSION\_UPDATED                            | Permission is changed.                                                 |
| PERMISSION\_DELETED:                           | Permission is removed.                                                 |
| GROUP\_CATEGORY\_CREATED                       | New group type is defined.                                             |
| GROUP\_CATEGORY\_UPDATED                       | Group type is changed.                                                 |
| GROUP\_CATEGORY\_DELETED:                      | Group type is removed.                                                 |
| PROVIDER\_CREATED                              | Signifies the addition of a new authentication provider to the system. |
| PROVIDER\_UPDATED                              | Indicates modifications made to an authentication provider's settings. |
| PROVIDER\_DELETED                              | Denotes the removal of an authentication provider from the system.     |
| GROUP\_NEW\_USER\_ADDED                        | Records the addition of a new user to a group.                         |
| INVITE\_USERRE\_INVITE\_USER                   | Invitation is sent again to a user                                     |
| INVITE\_ACCEPTEDINVITE\_REVOKED                | Invitation is accepted or canceled.                                    |
| USER\_CREATED\_WITH\_INVITE                    | User accounts are made using an invitation.                            |
| GROUP\_USER\_ROLE\_UPDATED                     | User's role in a group is changed.                                     |
| GROUP\_USER\_REMOVED                           | User removed from a group.                                             |
| TENANT\_CREATED                                | Records the creation of a new tenant.                                  |
| GROUP\_CREATED                                 | Marks the creation of a new group.                                     |
| GROUP\_UPDATED                                 | Changes are made to the group's details.                               |
| GROUP\_DELETED                                 | Group is removed.                                                      |
| SMS\_SENT                                      | Marks the sending of an SMS message.                                   |
| EMAIL\_SENT                                    | Indicates the sending of an email.                                     |
| IVR\_TRIGGERED                                 | Interactive voice response is activated.                               |
| PUSH\_SENT                                     | Push notification is sent.                                             |
| SCOPE\_CREATED                                 | Signifies the creation of a new scope.                                 |
| SCOPE\_UPDATED                                 | The scope's details are changed.                                       |
| SCOPE\_DELETED                                 | Scope is removed.                                                      |
| SCOPE\_DEC\_CREATED                            | Decision related to a scope is made.                                   |
| SCOPE\_DEC\_UPDATED                            | Changes are made to decision related to scope.                         |
| SCOPE\_DEC\_DELETED                            | Decision related to a scope is removed.                                |
| REGISTRATION\_FIELD\_CREATED                   | Marks the creation of a new registration field.                        |
| REGISTRATION\_FIELD\_UPDATED                   | Registration field has changed.                                        |
| REGISTRATION\_FIELD\_DELETED                   | Registration field is removed.                                         |
| GROUP\_TYPE\_CREATED                           | Signifies the creation of a new group type.                            |
| GROUP\_TYPE\_UPDATED                           | Indicates updates made to an existing group type's detail.             |
| GROUP\_TYPE\_DELETED                           | Group category is removed.                                             |
| HOSTED\_PAGE\_CREATED                          | New hosted page is made.                                               |
| HOSTED\_PAGE\_UPDATED                          | Hosted page's details are changed.                                     |
| HOSTED\_PAGE\_DELETED                          | Hosted page is removed                                                 |
| TEMPLATE\_CREATED                              | Marks the creation of a new template.                                  |
| TEMPLATE\_UPDATED                              | Changes are made to template.                                          |
| TEMPLATE\_DELETED                              | Template is removed.                                                   |
| CUSTOM\_TEMPLATE\_CREATED                      | New custom template is made.                                           |
| CUSTOM\_TEMPLATE\_UPDATED                      | Changes are made to custom template.                                   |
| CUSTOM\_TEMPLATE\_DELETED                      | <p>Custom template is removed. </p><p> </p>                            |
| WEBHOOK\_CREATED                               | New webhook is created.                                                |
| WEBHOOK\_UPDATED                               | Webhook is changed.                                                    |
| WEBHOOK\_DELETED                               | Webhook is removed.                                                    |
| CAPTCHA\_CREATED                               | New CAPTCHA is made.                                                   |
| CAPTCHA\_UPDATED                               | Changes are made to CAPTCHA.                                           |
| CAPTCHA\_DELETED                               | CAPTCHA is removed                                                     |
| PROFILE\_IMAGE\_UPDATED                        | User's profile image is changed.                                       |
| PROFILE\_IMAGE\_REMOVED                        | User's profile image is removed.                                       |
| MFA\_REQUIRED                                  | Users need to use multi-factor authentication.                         |
| <p>PHYSICAL\_VERIFICATION\_CONFIG </p><p> </p> | Settings for physical verification are defined.                        |
| PHYSICAL\_VERIFICATION\_REMOVED                | Physical verification settings are removed.                            |
| PHYSICAL\_VERIFICATION                         | Process of physically verifying something is started or completed.     |
| FLOW\_CREATED                                  | when a new Blueprint is created.                                       |
| FLOW\_UPDATED                                  | Existing Blueprint is updated.                                         |
| FLOW\_DELETED                                  | Existing Blueprint is Deleted                                          |
| MFA\_INITIATED                                 | The process of Multi-Factor Authentication begins.                     |
| MFA\_RE\_INITIATED                             | Restarting Multi-Factor Authentication                                 |
| MFA\_VERIFIED                                  | Multi-factor authentication is successfully confirmed.                 |

&#x20;
