DEV Community

Tanya Jha
Tanya Jha

Posted on

What is a Webhook. Explained the way I wish someone had told me.

When I first heard the word webhook, I imagined some scary backend magic 😭

But it’s actually one of those concepts that sounds harder than it is.

Imagine this:

You’re waiting for your crush to reply.

Option 1: You open WhatsApp every 30 seconds.

Seen? No.
Seen now? No.
Now?? Still no.

That’s like an API.

You keep asking:
“Any update?”
“Any update?”
“Any update?”

Option 2: You close the app and continue your life.

Then suddenly:
✨ ding
New message.

  • You didn’t ask.
  • You got notified.
  • That’s a webhook.

Webhook = “Don’t keep checking. I’ll tell you when something happens.”

Real life examples:

💳 You make a payment → payment successful → website gets notified

📦 Your package gets delivered → app automatically updates status

📧 Someone signs up → welcome email gets sent instantly

🛒 You place an order → confirmation arrives automatically

Tiny code example:

Someone buys a hoodie.

Store receives:

POST /order-confirmed
{
“order”: “#1042”,
“status”: “paid”
}

Store instantly shows: ✅ Order Confirmed

No refreshing.
No checking again and again.

So the easiest difference:

API → “Are we there yet?”
Webhook → “I’ll let you know when we arrive.”

And suddenly webhook sounds way less scary 🙂

Top comments (0)