---
title: Unsubscribe from an event (integrations) – API | Bannx
description: "Removes a subscription made with `POST /api/v1/integrations/hooks`, the way Zapier unsubscribes when a Zap turns off. Only removes subscriptions an integration created, in the key's space. Bearer API key with the `webhook.manage` scope."
source: https://bannx.com/docs/api/v1-integrations/integrations-unsubscribe-hook
---

Copy page

DELETE`/api/v1/integrations/hooks/:id`

#### Query / Path parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| id | path | Yes | Subscription id returned on subscribe. |

#### Responses

200

JSON { ok: true, id }

401

Missing or invalid API key, or the key lacks the webhook.manage scope (SCOPE_DENIED).

403

The key's user may not manage webhooks in the space (FORBIDDEN).

404

No integration subscription with that id in the key's space (HOOK_NOT_FOUND).

Request

```
curl -X DELETE "https://bannx.com/api/v1/integrations/hooks/:id" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{}'
```

Response

```
// JSON { ok: true, id }
{
  "success": true,
  "data": { ... }
}
```