Skip to main content
Use this endpoint to permanently delete a subscription. All address filters associated with the subscription are removed at the same time. Once deleted, the subscription ID cannot be recovered and no further events will be queued for delivery.

​
Request

DELETE /v1/subscriptions/:id

​
Headers

​
Path parameters

​
string
required
The subscription ID to delete. Always starts with sub_.

​
Example request

​
Response

204 No Content The response body is empty. A 204 status confirms the subscription has been deleted.
Deleting a subscription removes all its address filters permanently. Webhook deliveries that were already queued before deletion may still be delivered to your endpoint — disabling a subscription first gives in-flight deliveries time to complete before you remove the resource entirely.

​
Errors