Introduction

Webhooks let Okoora notify your system when events happen. Instead of polling the API for changes, your app receives updates automatically. When a relevant event occurs - like a payment update, account change, or transaction status - Okoora sends an HTTP request to your webhook endpoint (your URL). Your system can then react immediately.

How webhooks work

You create a webhook endpoint in your system (a URL that can receive requests).
You subscribe to events you want to track.
When an event occurs, Okoora sends a POST request to your endpoint.
The request includes a JSON payload describing the event.
Your server processes the payload and triggers whatever logic you need:
1. update internal records
2. run workflows
3. notify users

Why use webhooks?

Webhooks are the recommended way to stay up-to-date.

Real-time updates - Get notified the moment something changes.
More efficient than polling - Reduces unnecessary API calls and avoids rate-limit issues.
Reliable delivery - Webhook events include retry logic if your endpoint is temporarily unavailable.
Flexible integration - You choose which events to listen to and how your app handles them.