Skip to main content

​
POST /v1/webhooks

​
Body Parameters

ParameterTypeRequiredDescription
urlstring✓HTTPS endpoint URL
eventsarray✓Event types to subscribe to
secretstringSecret for signature verification

​
Example Request

curl -X POST https://api.boobie.ai/v1/webhooks \
  -H "Authorization: Bearer YOUR_BOOBIE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/webhooks/boobie",
    "events": ["engine.job.completed", "ip.registered"],
    "secret": "your_webhook_secret"
  }'

​
Response

{
  "id": "wh_abc123",
  "url": "https://yourapp.com/webhooks/boobie",
  "events": ["engine.job.completed", "ip.registered"],
  "status": "active",
  "created_at": "2026-06-12T09:00:00Z"
}