Skip to main content

​
Overview

Webhooks deliver real-time event notifications to your HTTPS endpoint when events occur in the boobie.ai platform.

​
Payload Structure

{
  "id": "evt_abc123",
  "type": "engine.job.completed",
  "data": {},
  "created_at": "2026-06-12T09:00:00Z"
}

​
Available Events

EventDescription
engine.job.completedA workflow job completed successfully
engine.job.failedA workflow job failed
creator.createdA new creator was provisioned
ip.registeredNew IP was registered
ip.verifiedIP verification completed

​
Retry Logic

On non-2xx responses, boobie.ai retries with exponential backoff: 1m, 5m, 30m, 2h, then stops.

​
Verifying Signatures

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return `sha256=${expected}` === signature;
}