What are webhooks?
Webhooks are HTTP POST requests that Baseerat sends to your server when specific events occur. They enable real-time integration with any system that can receive HTTP requests: your own backend, Zapier, Make, or any automation platform.
Registering a webhook
Go to Settings → Webhooks → New Webhook. Enter your endpoint URL and select the events to listen to. We will immediately send a verification request to your URL, respond with a 200 status code to confirm.
Available events
contact.created, contact.updated, contact.deleted, deal.created, deal.updated, deal.stage_changed, deal.deleted, activity.created, note.created, task.created, task.completed.
Payload format
All webhook payloads are JSON. Each payload includes: event (the event name), timestamp (ISO 8601), workspace_id, and data (the full object that changed). A deal.stage_changed event also includes previous_stage and new_stage.
Retries & reliability
If your endpoint returns a non-2xx status or times out (within 10 seconds), we retry with exponential backoff: at 1 min, 5 min, 30 min, and 2 hours. After 4 failed attempts, the webhook is marked as failed. You can replay failed webhooks from the dashboard.