Create Webhook

curl -X POST "https://api.danubeai.com/v1/webhooks" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/danube",
    "events": ["tool.execution.completed", "tool.execution.failed"],
    "description": "Production monitoring"
  }'

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "url": "https://example.com/webhooks/danube",
  "events": ["tool.execution.completed", "tool.execution.failed"],
  "is_active": true,
  "description": "Production monitoring",
  "secret": "whsec_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6"
}

POST

webhooks

curl -X POST "https://api.danubeai.com/v1/webhooks" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/danube",
    "events": ["tool.execution.completed", "tool.execution.failed"],
    "description": "Production monitoring"
  }'

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "url": "https://example.com/webhooks/danube",
  "events": ["tool.execution.completed", "tool.execution.failed"],
  "is_active": true,
  "description": "Production monitoring",
  "secret": "whsec_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6"
}

Overview

Create a new webhook to receive HTTP notifications when events occur. The response includes a signing secret that is only shown once — save it immediately. Auth: Requires JWT token (Authorization: Bearer <token>).

Body Parameters

url

string

required

The HTTPS URL to receive webhook deliveries. Must start with https://.

events

string[]

required

Event types to subscribe to. At least one is required.Valid values:

tool.execution.completed
tool.execution.failed
workflow.completed
workflow.failed
agent.spend.limit_approaching

description

string

Optional description for your reference (e.g. “Production monitoring”)

Response

string

Webhook UUID

url

string

The registered URL

events

string[]

Subscribed event types

is_active

boolean

Always true on creation

description

string

Optional description

secret

string

The signing secret (format: whsec_...). Only returned on creation. Use this to verify webhook signatures via HMAC-SHA256.

Example

curl -X POST "https://api.danubeai.com/v1/webhooks" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/danube",
    "events": ["tool.execution.completed", "tool.execution.failed"],
    "description": "Production monitoring"
  }'

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "url": "https://example.com/webhooks/danube",
  "events": ["tool.execution.completed", "tool.execution.failed"],
  "is_active": true,
  "description": "Production monitoring",
  "secret": "whsec_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6"
}

The secret field is only returned when the webhook is created. Store it securely — you will need it to verify webhook signatures. See the Webhooks guide for verification examples.

List Webhooks Update Webhook

​Overview

​Body Parameters

​Response

​Example

Overview

Body Parameters

Response

Example