---
title: "Unsubscribe from a webhook"
method: DELETE
path: "/webhooks/{subscription_id}"
tags: ["Webhooks"]
---

# Unsubscribe from a webhook

`DELETE /webhooks/{subscription_id}`

Remove a webhook subscription by ID

## Path parameters

- `subscription_id` string, required

## Response `200`

OK

- WebhookSubscription — Webhook subscription information
  - `created_at` string
  - `endpoint_url` string
  - `id` string
  - `is_active` boolean
  - `partner_id` string
  - `secret_last_4_digits` string
  - `topic` 'payout_paid' | 'payout_failed' | 'payout_processing' | 'payout_scheduled' | 'customer_created' | 'customer_updated' | 'customer_archived' | 'payment_succeeded' | 'payment_chargeback' | 'payment_refunded' | 'invoice_paid' | 'invoice_archived' | 'invoice_created' | 'invoice_updated' | 'payment_failed' | 'payment_method_added' | 'payment_method_deleted' | 'default_payment_method_changed' | 'vendor_created' | 'vendor_updated' | 'vendor_deactivated' | 'vendor_reactivated' | 'bill_created' | 'bill_updated' | 'bill_submitted' | 'bill_rejected' | 'bill_deleted' | 'vendor_payment_processing' | 'vendor_payment_succeeded' | 'vendor_payment_failed' | 'vendor_payment_canceled' | 'vendor_data_request_submitted'
  - `updated_at` string

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/alternativepayments/apis/alternative-payments.md) · [All operations](https://skmtc.net/alternativepayments/apis/alternative-payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alternativepayments/alternative-payments/revisions/730efda86cd1/schema)