QFind anything/

Create a webhook

Creates a webhook configuration for the tenant and environment.

Parameters

url(string)required

Webhook endpoint URL.

secret(string)required

Webhook secret for HMAC signing.

enabled(boolean)

Whether the webhook is enabled. Default: true.

subscribedEvents(array)required

Event types (e.g. incoming-transaction.created, match.created).

retryPolicy(object)required

Retry policy.

headers(object)

Custom headers to include.

timeout(number)

Request timeout in ms. Default: 30000.

POST/webhooks

curl -X POST "http://localhost:8000/api/v1/webhooks" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Tenant-Id: $TENANT_ID" \
  -H "X-Environment: production" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks",
    "secret": "whsec_...",
    "enabled": true,
    "subscribedEvents": ["incoming-transaction.created", "match.created"],
    "retryPolicy": {"maxAttempts": 5, "backoffStrategy": "exponential"}
  }'

Response(201)

{
  "id": "089fafeb-bfb2-491a-9fb3-718118e808be",
  "url": "https://example.com/webhooks",
  "enabled": true,
  "subscribedEvents": [
    "incoming-transaction.created"
  ],
  "createdAt": "2025-02-01T10:00:00.000Z"
}