Create a webhook
POST
The response carries signing_secret, the only time Ricky shows it.
Scope: webhooks:manage.
bearerAuthheader
AuthorizationBearer <token>An organization API key, rky_live_…, created in Settings → API. Send it only from a server.
application/json- body
url*stringPublic HTTPS endpoint.
Format
uriLength
length <= 2048event_types*array<>Items
1 <= items <= 5Success.
application/json- response
data*A new webhook subscription with its signing secret.
curl -X POST 'https://getricky.ai/api/v1/webhooks' \ -H 'Content-Type: application/json' \ -d '{ "url": "https://example.com/ricky/webhooks", "event_types": [ "message.received", "conversation.closed" ]}'{ "data": { "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b", "url": "https://example.com/ricky/webhooks", "event_types": [ "message.received" ], "status": "active", "created_at": "2026-10-14T15:30:00.000Z", "disabled_at": "2026-10-14T15:30:00.000Z", "signing_secret": "whsec_7Yb2kQ9…" }}