---
title: "Delete a webhook"
method: DELETE
path: "/v1/webhooks/{webhook_id}"
tags: ["Webhook"]
---

# Delete a webhook

`DELETE /v1/webhooks/{webhook_id}`

## Headers

- `X-Encircle-Attribution` string
- `X-Encircle-Request` string

## Response `200`

The `Webhook` was deleted successfully.

- WebhookResponse — We offer webhook integration to inform your organization's web server when media objects (pictures, videos, documents) are created or updated in Encircle. Webhooks are configured to listen for media objects in *all* claims your organization has access to. If you would like to use our webhook service, please contact [support@encircleapp.com](mailto:support@encircleapp.com).
  - `id` integer, required — The `id` of the `Webhook`.
  - `delivery_url` string, required — An HTTPS endpoint URL the Webhook will deliver payloads to. The URL should be unique per Organization / bearer token so your system can authenticate any necessary follow-up requests. Your domain must also be whitelisted, contact [support@encircleapp.com](mailto:support@encircleapp.com) If the status code returned by the endpoint is 410, then a resource required to fire the appropriate `Webhook` event is unavailable, at which point the `Webhook` will stop listening for that event.
  - `events` string[], required
  - `authentication` object — Optionally specify an authentication scheme that can be used by third party systems to verify that requests originate from Encircle systems. If you require an authentication type other than shared_secret, please contact support@encircleapp.com
    - `type` 'jwt' | 'oauth' | 'shared_secret', required — The type of authentication this Webhook utilizes. For now, only "shared_secret" can be accessed through the API.
    - `header_name` 'Authorization' | 'ocp-apim-subscription-key', required — The HTTPS header field name whose value will be 'shared_secret'. Permitted values are: "Authorization", "ocp-apim-subscription-key". If this not provided in the request, the default, "Authorization", will be used when event payloads are sent to 'delivery_url'.
    - `shared_secret` string, required — The non-empty string to be included as an `Authorization` header when event payloads are sent to `delivery_url`.

## Other responses

- `400` — Error processing request.
- `401` — Authentication error.
- `404` — Requested resource does not exist.

---

[API](https://skmtc.net/encircleapp/apis/encircle-public-api.md) · [All operations](https://skmtc.net/encircleapp/apis/encircle-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/encircleapp/encircle-public-api/versions/0e70222a2c6d/schema)