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

# De-register Webhook

> Suggest Edits

Deregistering a webhook via API involves removing a previously registered webhook configuration from the application. To
disable notification related to particular transaction events, you need to de-register webhook with registered events
name.

Once deregistered, the previously registered webhook will no longer be triggered by the API, and notifications will
no longer be delivered to the configured endpoint.

<Note>
  This route is secured with **processor** and **vendor** token authentication.
</Note>

### Endpoint

DELETE   **/3p/api/v1/webhook**

### Request Payload

<CodeGroup>
  ```json json theme={"system"}
  {
      "webhook_url": [
        "https://example.com/webhook/transaction"
      ],
      "event_names": [
        "TransactionCompleted",
        "TransactionFailed"
      ]
  }
  ```
</CodeGroup>

| Fields           | Type         | Is Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ---------------- | ------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **event\_names** | string array | Yes         | *Possible Values:* TransactionStarted TransactionCaptureStarted TransactionCompleted TransactionFailed TransactionCanceled PayoutFailed PayoutCompleted ClawbackStarted ClawbackFailed ClawbackCompleted BankLinkedSuccessfully BankLinkFailed BankAccountRemoved BusinessCreated BusinessUpdated BatchPayout (only by processor token) RefundPending RefundCaptureStarted RefundCaptureCompleted RefundCaptureFailed RefundPayoutPending RefundPayoutCompleted RefundPayoutFailed BatchRefund (only by processor token) ReversePayoutStarted ReversePayoutCompleted ReversePayoutFailed |
| **webhook\_url** | string array | No          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

### Response Object

<CodeGroup>
  ```json JSON (201) theme={"system"}
  {
      "status": true,
      "message": "Webhook de-registered!",
      "data": null,
      "errors": []
  }
  ```
</CodeGroup>

### Errors & Warnings

| Code | Message |
| ---- | ------- |
| 401  |         |
| 422  |         |

***

* [Table of Contents](#)

* * [Endpoint](#endpoint)
  * [Request Payload](#request-payload)
  * [Response Object](#response-object)
  * [Errors & Warnings](#errors--warnings)
