Back to Glossary
Technology
Webhook
Quick answer
HTTP push notification sent automatically on event - the opposite of "polling".
Key takeaways
- REST polling: ask the API every 1-5 min "anything new?" → 12-60 useless calls/hour
- Webhook: notified in under 1 sec on change → 0 useless calls, minimal latency
Definition
A webhook (or "HTTP callback") is the mechanism by which a system automatically sends an HTTP POST to a pre-configured URL when an event happens (new order, invoice issued, delivery confirmed).
Why it beats polling
- REST polling: ask the API every 1-5 min "anything new?" → 12-60 useless calls/hour
- Webhook: notified in under 1 sec on change → 0 useless calls, minimal latency
CRMconnect events exposed as webhooks
- order.created / order.shipped / order.delivered
- invoice.issued / invoice.paid
- inventory.low_stock / inventory.reserved
- partner.created / partner.updated
- chargeback.received
Webhook receiver best practices
- Respond HTTP 200 fast (under 5 sec), process async
- Validate signature (HMAC) for security
- Idempotency: the same event may be delivered multiple times
Last updated:
Frequently asked
What if my URL is down?+
CRMconnect retries with exponential backoff (5 min, 30 min, 2h, 12h, 24h). After 5 attempts the event lands in a dead-letter queue, visible in admin.