Skip to main content
POST
Create webhook

Authorizations

Authorization
string
header
required

Bearer token authentication used for standard API calls. Format: 'Bearer YOUR_API_KEY'

Body

application/json
name
string
required

Display name of the webhook

Example:

"Production Webhook"

url
string<uri>
required

URL that will receive webhook events

Example:

"https://your-app.example.com/webhooks/lava"

Response

Webhook created (includes webhook_secret — only returned once)

Webhook with secret. The webhook_secret is only returned once on creation.

webhook_id
string
required

Unique identifier for the webhook

name
string
required

Display name of the webhook

url
string
required

URL that receives webhook events

webhook_secret
string
required

Secret used to verify webhook signatures. Only returned once on creation.

created_at
string<date-time>
required

When the webhook was created