Skip to main content
POST
/
partner
/
v1
/
webhooks
curl -X POST https://prod.api.unleeshed.ai/partner/v1/webhooks \
  -H "X-Api-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-domain.com/webhooks/unleeshed",
    "events": ["creator.approved", "partner.approved", "commentary.failed"]
  }'

{
  "success": true,
  "data": {
    "id": "whk_abc123",
    "url": "https://your-domain.com/webhooks/unleeshed",
    "events": ["creator.approved", "partner.approved", "commentary.failed"],
    "secret": "whsec_a1b2c3d4...",
    "status": "active",
    "consecutive_failures": 0,
    "last_delivery_at": null,
    "created_at": "2026-02-04T10:00:00Z",
    "updated_at": "2026-02-04T10:00:00Z"
  }
}
Register a webhook endpoint to receive event notifications.
The webhook secret is only returned in this response. Store it securely for signature verification.

​
Request Body

​
url
string
required
HTTPS URL to receive webhook POST requests
​
events
string[]
required
Events to subscribe to. Valid values: creator.approved, partner.approved, commentary.failed
​
secret
string
Optional custom secret (min 32 chars). If not provided, one is generated.

​
Response

​
id
string
Unique webhook ID
​
url
string
The registered webhook URL
​
events
string[]
Subscribed event types
​
secret
string
Webhook signing secret (only returned on creation)
​
status
string
Webhook status: active, paused, or disabled
curl -X POST https://prod.api.unleeshed.ai/partner/v1/webhooks \
  -H "X-Api-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-domain.com/webhooks/unleeshed",
    "events": ["creator.approved", "partner.approved", "commentary.failed"]
  }'

{
  "success": true,
  "data": {
    "id": "whk_abc123",
    "url": "https://your-domain.com/webhooks/unleeshed",
    "events": ["creator.approved", "partner.approved", "commentary.failed"],
    "secret": "whsec_a1b2c3d4...",
    "status": "active",
    "consecutive_failures": 0,
    "last_delivery_at": null,
    "created_at": "2026-02-04T10:00:00Z",
    "updated_at": "2026-02-04T10:00:00Z"
  }
}