# V6.14.0 - Withdrawal Webhook

**Released Date - 30 August 2023**

We are thrilled to unveil the new Withdrawal Webhook feature within our CRM. This enhancement empowers you to effortlessly and securely submit withdrawal requests directly from the CRM to a designated destination URL using Webhooks. With this innovative addition, you can now seamlessly streamline your withdrawal process and enhance operational efficiency.

### <mark style="color:red;">Summary</mark>

#### [Withdrawal Webhook](#withdrawal-webhook-1)

1. **Efficient Workflow:** The withdrawal process is streamlined as data is transmitted directly to the third-party provider, eliminating the need for manual input from your end.
2. **Data Precision and Reliability:** Automated data transmission guarantees precision in withdrawal amount and recipient account details, ensuring consistent and accurate information exchange.
3. **Tailored to Your Process:** The webhook function is adjustable to match your unique withdrawal process, empowering you to define the precise action trigger point for the communication of data through the webhook.

### <mark style="color:red;">Withdrawal Webhook</mark>

#### 1)   New Settings Navigation Tab - Dev Space

1. We are pleased to introduce a brand-new Settings Navigation Tab titled "Dev Space."&#x20;
2. As part of this update, we have relocated both "Open API Keys" and "Security Credentials" to reside under this new tab.&#x20;
3. Furthermore, we have included the addition of "Webhooks" within this same section.&#x20;
4. This restructuring aims to enhance accessibility and organization while providing a centralized navigation tab for managing these key features.<br>

   <figure><img src="/files/ymn6cxaI4ysgLUUG7qO9" alt=""><figcaption></figcaption></figure>

#### 2)   Permission Settings

The permission settings have been restructured to encompass the newly introduced navigation tab: "Dev Space." Within this tab, permissions for Open API keys and security credentials have been relocated, and permissions for webhooks have also been incorporated.

In order to begin utilizing webhooks, it's important to enable the respective permissions:

1. Read Webhooks: Grants read-only access to Webhooks.
2. Update Webhooks: Provides the ability to edit Webhooks.

<figure><img src="/files/OcEq1gyVPN0MAFFc8IVV" alt=""><figcaption></figcaption></figure>

#### 3)   Webhook API Documentation

1. To initiate your usage of webhooks, simply click on "Learn More" to access the API documentation dedicated to webhooks.

   <figure><img src="/files/ysINLZIxCYt6QICImiDB" alt=""><figcaption></figcaption></figure>
2. Upon clicking, you'll be directed to a new tab containing the API documentation.<br>

   <figure><img src="/files/8kTOtiktA8SE67A2Imab" alt=""><figcaption></figcaption></figure>

#### 4)   Creating Webhooks

To create a new webhook, follow these steps:&#x20;

{% tabs %}
{% tab title="Step 1" %}
Click "Create Webhook".&#x20;

<figure><img src="/files/kCO9yrNoCsE62ug1GXjr" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2" %}
Fill in the respective fields:&#x20;

1. Name - this refers to the name of the webhook.&#x20;
2. Destination URL - this is the URL where the information will be received.&#x20;
3. Select Function - currently, webhooks only support withdrawals.&#x20;
4. Select Event - this determines when information is transmitted via the webhook to the destination URL.&#x20;
   * Approve Withdrawal - Node N
     1. N corresponds to the approver level.
     2. If you select both Node 1 and 2, it means that if the level 1 or 2 approver approves the withdrawal request, information will be sent through the webhook. This configuration should be aligned with your withdrawal process.&#x20;
   * Reject Withdrawal: Information will be sent to the destination URL when withdrawal requests are rejected.&#x20;
5. Secret Key

Click "Save" to successfully create the new webhook.&#x20;

<figure><img src="/files/FV3CTpmcVEpMZgr6gJqr" alt="" width="301"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

#### 5)   Editing Webhooks

To edit a webhook, follow these steps:&#x20;

{% tabs %}
{% tab title="Step 1" %}
Locate the desired webhook and click the "Edit" icon.&#x20;

<figure><img src="/files/gCPcGi0jy9KNHykJ7O3J" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2" %}

1. Make the necessary changes.&#x20;
2. Confirm your changes by clicking "Save". &#x20;

   <figure><img src="/files/DpDJmpaqgtWGbS01xF8R" alt="" width="294"><figcaption></figcaption></figure>

{% endtab %}
{% endtabs %}

#### 6)   View History

1. To access webhook logs, simply click on the "History" icon.

   <figure><img src="/files/1WdEW58XJUBFV751WTSV" alt=""><figcaption></figcaption></figure>
2. You will be able to view the details of each log.&#x20;

   <figure><img src="/files/bnGiVRDk9CTiMvvB7qgU" alt=""><figcaption></figcaption></figure>
3. You can review the details of the webhook request by simply clicking on it.

   <figure><img src="/files/4ml2dfRPnAx9HpkDCuPD" alt=""><figcaption></figcaption></figure>
4. Should you wish to re-send a specific request, click on the "Resend" icon.&#x20;

   <figure><img src="/files/hb749FBo69GkE3qIKqlF" alt=""><figcaption></figcaption></figure>
5. A confirmation popup will appear before proceeding with the action.

   <figure><img src="/files/24zg5DaQ50sFHW6uh4RG" alt="" width="294"><figcaption></figcaption></figure>

#### 7)   Disable Webhooks

To disable webhooks, follow these steps:&#x20;

{% tabs %}
{% tab title="Step 1" %}
Find the specific webhook you wish to disable and select the "Disable" icon.

<figure><img src="/files/Uysd3d7A4Ps7KJN9oRRe" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2" %}

1. Once a webhook is disabled, it will cease to transmit messages to the designated destination URL.
2. To reactivate the webhook, simply click on the same icon.
   {% endtab %}
   {% endtabs %}

#### 8)   Delete Webhooks

To delete a webhook, follow these steps:&#x20;

{% tabs %}
{% tab title="Step 1" %}
Find the desired webhook and click the "Delete" icon.

<figure><img src="/files/0QzC2gNkzrCMjK4OHwZm" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2" %}

1. A popup confirmation message will appear for your verification.
2. Click "Confirm" to proceed with the deletion.

   <figure><img src="/files/N630OwWLn6tlk1j0qOFv" alt="" width="248"><figcaption></figcaption></figure>

{% endtab %}
{% endtabs %}

#### 9)   Reviewing Withdrawal Requests

1. When clients submit a withdrawal request, and upon the occurrence of the first triggered event (as configured for the webhook), the data will be sent to the designated destination URL.
2. The transmitted information will encompass the data boxed up in yellow in the provided image.

   <figure><img src="/files/3wIgcNEI1UqlSEq6GMBw" alt="" width="563"><figcaption></figcaption></figure>
3. After the withdrawal process is completed in the third-party system, you can proceed with the subsequent review steps for the submitted request.


---

# 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://reference-guide.gitbook.io/crm-version-release-notes/v6.14.0-withdrawal-webhook.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.