Voicegram

Soft-delete a webhook subscription

Soft-deletes a webhook subscription by setting `is_active=false`.

On this page

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

NameTypeRequiredDescription
idstring (uuid)yesThe 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.

429Too Many Requests

Per-account rate limit exceeded.

See Errors for the shared error response shape.

500Internal Server Error

Unexpected server error.

See Errors for the shared error response shape.

Need help? Email support@voicegram.io.