Delete Webhook
The Delete Webhook endpoint permanently removes a webhook and all of its delivery history. Unlike Delete Template, this is a hard delete: the webhook row and its delivery records are removed from the database, not deactivated. There is no un-delete.
When to use it
Use this endpoint when you are decommissioning an integration and no longer want TurboDocx to call your endpoint. If you only want to pause delivery temporarily, use Update Webhook with isActive: false instead, so you keep the secret and delivery history.
Example request
curl -X DELETE "https://api.turbodocx.com/api/webhooks/signature" \
-H "Authorization: Bearer $TURBODOCX_API_KEY" \
-H "x-rapiddocx-org-id: $TURBODOCX_ORG_ID" \
-H "Accept: application/json"
Example response
On success the endpoint returns 200 OK:
{
"message": "Webhook deleted successfully"
}
Common errors
| Status | When | Response body |
|---|---|---|
| 401 | Missing or invalid API key/token, or the organization cannot be resolved | Empty (status only) |
| 403 | The key's role is not administrator | Empty (status only) |
| 404 | No webhook with that name exists in your organization | { "error": "Webhook not found" } |
Related endpoints
-
Get Webhook to confirm the webhook's configuration before deleting it
-
Update Webhook to pause delivery instead of deleting
-
Create Webhook to register a new webhook afterward
DELETE/api/webhooks/signature