Skip to main content

Delete webhook endpoint

DELETE 
/api/v1/sdk/stores/:storeId/webhooks/:webhookId

This endpoint permanently deletes a webhook endpoint. This action cannot be undone.

Authentication: Requires Private API Key (sk_*) with Administer permission

Deletion Behavior:

  • Webhook is immediately disabled
    • All pending deliveries are cancelled
    • Webhook configuration and history are deleted
    • This operation cannot be undone
Use Cases:
  • Removing unused webhooks
    • Cleaning up test webhooks
    • Decommissioning integrations
Important Notes:
  • Consider disabling instead of deleting if temporary removal needed
    • Deletion is immediate and permanent
    • No events will be sent after deletion
Error Scenarios:
  • 404 NOT FOUND - Webhook or store not found (Error code: WEBHOOK_NOT_FOUND or STORE_NOT_FOUND)
    • 401 UNAUTHORIZED - Invalid or missing API key (Error code: INVALID_API_KEY)
    • 403 FORBIDDEN - Insufficient permissions (Error code: INSUFFICIENT_PERMISSIONS)

Request​

Responses​

Webhook endpoint deleted successfully (no content)