# Webhooks

This tutorial explains how to add or edit a webhook within the OMS screens. Webhooks are used to transfer events and data from the OMS to third-party software, enabling real-time communication and automation.

## <mark style="color:red;">Step 1: Access Webhooks​</mark> <a href="#step-1-access-webhooks" id="step-1-access-webhooks"></a>

* To add a new webhook, start by selecting the **Settings** tab under the Akinon OMS menu.
* Next, click on **Webhooks**.<br>

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FZTKgiRUSjzDP0aMUXDUo%2Fimage.png?alt=media&#x26;token=f0963e07-2656-4266-8058-5c06952f9cd2" alt=""><figcaption></figcaption></figure>
* Click on the **+New Webhook** button to add new webhook.<br>

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FdBY3iv5wzslblQluRuTz%2Fimage.png?alt=media&#x26;token=d313137f-2562-4f12-94bb-dcac91d08192" alt=""><figcaption></figcaption></figure>
* To edit an existing webhook, follow the same steps to access **Webhooks** under the **Settings** tab. Select the webhook you want to edit from the list and proceed to its details.<br>

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2F977aWrh7Deet7xLXDzJ0%2Fimage.png?alt=media&#x26;token=2b4fb069-618b-46be-989e-a6aa5f1e7ee5" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 2: Configure Webhook​</mark> <a href="#step-2-configure-webhook" id="step-2-configure-webhook"></a>

Akinon OMS uses webhooks to relay the events it triggers to third-party software. These events can include outcomes stemming from OMS actions or updates regarding domain objects' current states.

The data required for the Webhook Form is furnished by the third-party software and can be customized through JSON configuration.

* To add or edit a webhook, you need to provide the following information:

  * **Target URL**: The URL that other Akinon or third-party services receive to connect. The URL received by other Akinon or third-party services to connect.

  * **Secret Ket**: It is not a required field, if it is provided by other services to be connected.

  * **Event Type**: Enter a distinctive name to the Event Type field, especially if you have multiple webhooks, to differentiate them easily.

  * **Callback**: This field can be configured via JSON as needed.

  * **Additional Headers**: If there is extra data to be sent along with the settings or configuration, enter it here for routing from Akinon OMS to other Akinon or third-party services.

  * **Config**: The Config field allows you to provide a JSON Config in accordance with the specifications expected by the webhook.

  > **Note:** If there is no Additional Headers or Config to enter, these fields can be left empty by using "**{}**".

  * **Retry Countdown Config**: Specify a time interval for retrying data routing through this webhook, if necessary.
  * **Status**: Set the Status to **Active** if you want to use this webhook.\ <br>

    <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FuI9NVvtjn3FlKb2YYZJJ%2Fimage.png?alt=media&#x26;token=da3d3e6b-204b-45bf-86b1-14c50563a2c4" alt="" width="375"><figcaption></figcaption></figure>