---
title: "Unsubscribe"
method: DELETE
path: "/api/v1/webhooks/{id}"
tags: ["Webhooks (v1, deprecated)"]
deprecated: true
---

# Unsubscribe

`DELETE /api/v1/webhooks/{id}`

## Request

- Base URL: `https://app.formaportal.com`
- URL: `https://app.formaportal.com/api/v1/webhooks/{id}`
- Auth: OAuth 2 (authorization code, authorization URL `https://app.formaportal.com/oauth/authorize`, token URL `https://app.formaportal.com/api/oauth/token`, scopes: `webhooks:write`)

> **Deprecated.**

Removes a subscription belonging to the calling connection. Deleting one that is already gone succeeds, so retries are safe.

## Path parameters

- `id` string, required

## Response `200`

Removed (or already absent).

- object
  - `deleted` integer

## Other responses

- `401`: Missing, invalid, expired or revoked token. The `WWW-Authenticate` header points at the protected-resource metadata.
- `403`: The token is valid but lacks a required scope. `WWW-Authenticate` names the scopes needed.

---

[API](https://skmtc.dev/formaportal/apis/formaportal-api.md) · [All operations](https://skmtc.dev/formaportal/apis/formaportal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/formaportal/apis/formaportal-api/revisions/a9412c3b13cb?raw)