Skip to main content

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​

StatusWhenResponse body
401Missing or invalid API key/token, or the organization cannot be resolvedEmpty (status only)
403The key's role is not administratorEmpty (status only)
404No webhook with that name exists in your organization{ "error": "Webhook not found" }
  • 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