Skip to main content
DELETE
/
webhooks
/
{id}
Delete Webhook
curl --request DELETE \
  --url https://api.example.com/webhooks/{id} \
  --header 'Authorization: <authorization>'
Deletes a webhook configuration.

​
Overview

Permanently delete a webhook configuration. Pending deliveries will not be sent after deletion.
This action is irreversible. All pending deliveries for this webhook will be cancelled and not sent.

​
Authentication

​
Authorization
string
required
Bearer token with write:webhooks scope

​
Path Parameters

​
id
string
required
The webhook configuration ID (UUID v4)

​
Response

Returns 204 No Content on successful deletion.

​
Example Request

curl -X DELETE https://api.instaview.sk/webhooks/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer sk_your_key_here"

​
Error Responses

{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Webhook configuration not found"
  }
}

{
  "success": false,
  "error": {
    "code": "RESOURCE_ACCESS_DENIED",
    "message": "Access denied to this webhook configuration"
  }
}

​
Best Practices

Before deleting a webhook:
  1. Disable first - Set isActive: false to test impact
  2. Monitor for issues - Ensure no critical integrations depend on it
  3. Update dependent systems - Notify systems expecting webhook deliveries

​
Alternative: Disable Instead of Delete

If you might need the webhook later, consider disabling it instead: 
// Disable instead of delete
await fetch(`https://api.instaview.sk/webhooks/${webhookId}`, {
  method: 'PATCH',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    isActive: false
  })
});

List Webhooks

List all webhook configurations

Create Webhook

Create a new webhook