Unsubscribe from an event (integrations)
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.
Unsubscribe from an event (integrations)
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.
/api/v1/integrations/hooks/:idQuery / 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": { ... }
}