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"
}
}
Webhooks
Register Webhook
Register a new webhook endpoint
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
string
required
HTTPS URL to receive webhook POST requests
string[]
required
Events to subscribe to. Valid values:
creator.approved, partner.approved, commentary.failedstring
Optional custom secret (min 32 chars). If not provided, one is generated.
Response
string
Unique webhook ID
string
The registered webhook URL
string[]
Subscribed event types
string
Webhook signing secret (only returned on creation)
string
Webhook status:
active, paused, or disabledcurl -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"
}
}