Definition

Webhook

A webhook is an automated HTTP callback mechanism where an external service sends a real-time notification to your application by making an HTTP request to a specified URL whenever a specific event occurs.

Understanding Webhook

Webhooks enable real-time communication between applications. Instead of your app repeatedly checking whether something happened in an external service, the external service notifies your app when the event occurs. Common examples include payment confirmations from Stripe, push notifications from GitHub when code is pushed, and order updates from e-commerce platforms.

In vibecoded applications, webhooks are often involved in payment processing, email notifications, and third-party integrations. The AI might generate webhook handling code that works for the basic success case but fails to handle retries, verify webhook signatures, or process events that arrive out of order.

Webhook-related bugs are particularly tricky to test because they involve external services sending data to your application at unpredictable times. During QA testing, testers can trigger webhooks by performing the actions that cause them, such as making a test payment, and then verifying that the application correctly processes the resulting notification. Failures in webhook handling often manifest as features that intermittently do not work, making them frustrating for users and difficult to diagnose.

Example usage

Customers reported that their orders were sometimes marked as unpaid even after successful payment. The Stripe webhook was failing silently because the AI did not implement signature verification.

Related terms

Learn more