Recently, I wound up in a discussion with a coworker about webhooks. (Specifically, my hope that Okta offers them. I’ve spent several hours reading this documentation and I still can’t tell.) She wasn’t familiar with them, and neither was the customer who we were looping in as part of the larger discussion. So, I wound up explaining webhooks as follows:
Think of our two services as two people: you, in the back of the office, and your coworker George who sits near the kitchen and can see the microwave. You want to know if the popcorn you just put in the microwave is done, but can’t wait around in the kitchen. (Your office is very strict about loitering.)
Emchap.com 