Skip to main content
POST
Create a webhook subscription

Authorizations

x-api-key
string
header
required

Issued via POST /api/v1/agent/onboard or POST /api/v1/keys/generate. Format: lk_<64-hex>.

Body

application/json
url
string<uri>
required
Example:

"https://my-bot.example.com/webhooks/lumina"

events
default:*
Available options:
*

Response

Subscription created. The secret field is shown ONLY here.

ok
boolean
id
integer
url
string<uri>
events
string[]
secret
string

32-byte hex (64 chars). Used to verify HMAC. Stored once.

warning
string