Configure Webhooks

Create a new webhook endpoint

POST /v1/webhooks

cURL

curl -X POST https://api.raily.ai/v1/webhooks \
  -H "Authorization: Bearer raily_sk_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.example.com/webhooks/raily",
    "events": ["access.granted", "access.denied"],
    "secret": "whsec_your_secret"
  }'

Success (201)

{
  "id": "wh_abc123",
  "object": "webhook",
  "url": "https://api.example.com/webhooks/raily",
  "events": ["access.granted", "access.denied"],
  "secret": "whsec_your_secret",
  "status": "active",
  "created": "2024-01-15T10:30:00Z"
}

Request Body

url · string · required

The HTTPS URL to receive webhook events

events · array · required

Events to subscribe to

secret · string

Secret for signature verification (auto-generated if not provided)

metadata · object

Custom metadata

Available Events

Event	Description
access.granted	Content access approved
access.denied	Content access blocked
access.rate_limited	Rate limit exceeded
content.created	New content registered
content.updated	Content updated
content.deleted	Content deleted
policy.created	Policy created
policy.updated	Policy updated
analytics.threshold	Analytics threshold exceeded

cURL

curl -X POST https://api.raily.ai/v1/webhooks \
  -H "Authorization: Bearer raily_sk_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.example.com/webhooks/raily",
    "events": ["access.granted", "access.denied"],
    "secret": "whsec_your_secret"
  }'

Success (201)

{
  "id": "wh_abc123",
  "object": "webhook",
  "url": "https://api.example.com/webhooks/raily",
  "events": ["access.granted", "access.denied"],
  "secret": "whsec_your_secret",
  "status": "active",
  "created": "2024-01-15T10:30:00Z"
}