Webhooks
Endpoints for managing webhooks that receive real-time event notifications.
/api/v1/settings/webhooksList all webhooks for the authenticated user.
Authentication
Authentication required (any valid API key)
/api/v1/settings/webhooksCreate a new webhook. HTTPS URLs only.
Authentication
settings:writeRequest Body
{
"name": "Discord Notify",
"url": "https://example.com/webhook",
"secret": "optional-signing-secret",
"notifyOnQuestionReceived": true,
"notifyOnAnswerSent": false
}/api/v1/settings/webhooks/:idUpdate an existing webhook.
Authentication
settings:writeRequest Body
{
"name": "Updated Name",
"url": "https://example.com/webhook",
"secret": "new-secret",
"notifyOnQuestionReceived": true,
"notifyOnAnswerSent": true,
"isActive": true
}Fields not included in the request body are left unchanged.
/api/v1/settings/webhooks/:idDelete a webhook.
Authentication
settings:write/api/v1/settings/webhooks/:id/deliveriesGet the last 50 delivery logs for the specified webhook.
Authentication
Authentication required (any valid API key)
Response
{
"logs": [
{
"id": "...",
"eventType": "QUESTION_RECEIVED",
"success": true,
"statusCode": 200,
"error": null,
"attemptedAt": "2026-02-14T00:00:00.000Z"
},
...
]
}/api/v1/settings/webhooks/testSend a test payload to a webhook URL.
Authentication
settings:writeRequest Body
{
"url": "https://example.com/webhook",
"secret": "optional-signing-secret"
}Payload Format
Webhook payloads are sent as POST requests with a JSON body.
{
"type": "QUESTION_RECEIVED",
"timestamp": "2026-02-14T00:00:00.000Z",
"data": { ... }
}Signature Verification
When a secret is configured, each request includes an X-Hub-Signature header containing an HMAC-SHA256 signature of the raw request body.
X-Hub-Signature: sha256=<hmac-hex>