POST
/v1/webhook_endpointsWebhooks
Register HMAC-signed event delivery for run.completed, budget.exceeded, wallet.low, and more.
Request
- HTTP
- POST
- URL
- /v1/webhook_endpoints
- Auth
- api_key
Try it
curl https://api.fightclub.pro/v1/webhook_endpoints \
-H "Authorization: Bearer $FC_API_KEY" \
-d '{"url":"https://yourapp.com/wh/fc","events":["budget.exceeded","run.completed"]}'Parameters
| Name | Type | Description |
|---|---|---|
| url* | string | Receiver URL. |
| events* | array | Event types to subscribe to. |
| description | string | Free-form label. |
Response fields
| Name | Type | Description |
|---|---|---|
| id | string | Webhook endpoint ID (wh_*). |
| secret | string | HMAC signing secret (returned once on create). |
Errors
- 401
invalid_api_key, Missing or revoked key. - 400
invalid_url, URL must be https.
See the full error reference.