Developers / Webhooks
React the moment a lead lands or a campaign changes.
Webhooks push events from BuzinessAI to your server in real time, so you can route new leads, alert your team when an ad is rejected or sync published posts without polling.
app.post("/webhooks/buziness", (req, res) => {
const event = buziness.webhooks.constructEvent(
req.body,
req.headers["buziness-signature"],
process.env.BUZINESS_WEBHOOK_SECRET
)
if (event.type === "lead.created") {
assignToRep(event.data.lead)
}
res.sendStatus(200)
})Signed payloads
Every event carries a signature header so you can verify it came from BuzinessAI before acting on it.
Automatic retries
Failed deliveries are retried with exponential backoff for up to three days, and events arrive with a unique ID.
Replay on demand
Inspect every delivery attempt in the dashboard and resend any event after you fix a bug.
Events you can subscribe to. Pick only the ones your integration needs.
- Leadslead.createdA new lead arrived from a campaign or form
- Leadslead.stage_changedA lead moved to a different pipeline stage
- Adscampaign.publishedA campaign went live on Meta or Google
- Adscampaign.budget_exhaustedA campaign hit its spend cap and paused
- Adsad.rejectedA platform rejected an ad during review
- Postspost.publishedA scheduled post went live on a channel
- Postspost.failedA post could not be published and needs attention
- Designdesign.exportedA design was exported and is ready to use
Set up an endpoint. Three steps to reliable, real-time events.
- 01
Register your URL
Add an HTTPS endpoint in the dashboard or via the API and choose the events it should receive.
- 02
Verify every signature
Use your endpoint's signing secret with the SDK helper to reject anything that wasn't sent by BuzinessAI.
- 03
Respond quickly
Return a 2xx within a few seconds and do slow work in a background job, so deliveries never time out.
Ready to start building?
Get an API key, follow the quickstart and send your first request in minutes.