Soft-delete a webhook subscription
Soft-deletes a webhook subscription by setting `is_active=false`.
Soft-deletes a webhook subscription by setting is_active=false. The row and its delivery history are preserved for audit. Used by the Zapier app's unsubscribe flow and the dashboard "Delete" button. Returns 404 whether the subscription does not exist or belongs to a different account.
Endpoint
http
DELETE /api/v1/webhook-subscriptions/{id}
Authentication
Bearer Personal Access Token. See Authentication.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string (uuid) | yes | The Voicegram-issued subscription id (UUID). |
Example request
bash
curl -X DELETE https://www.voicegram.io/api/v1/webhook-subscriptions/:id \
-H "Authorization: Bearer vg_pat_<your-token>"
Responses
204No Content
Subscription soft-deleted
401Unauthorized
The PAT is missing, malformed, expired, or revoked.
See Errors for the shared error response shape.
403Forbidden
PAT is valid but the account is on the free plan.
See Errors for the shared error response shape.
404Not Found
Returned whether the subscription does not exist or belongs to a different account.
See Errors for the shared error response shape.
Need help? Email support@voicegram.io.