Skip to main content
POST
Create an outbound webhook (dashboard, reveal-once secret)

Authorizations

Authorization
string
header
required

Clerk dashboard session JWT. Used on dashboard, billing, playground, and admin console routes only:

These are human-session credentials, not API keys. The dashboard frontend must never send authoritative account IDs, plan values, quota counters, Stripe IDs, or API-key actor fields — the server derives ownership from the session. Admin console routes additionally require the custom admin_role claim (admin or support) on the same verified session JWT; writes require admin.

Body

application/json
url
string
required

HTTPS endpoint to deliver events to.

events
enum<string>[]
required
Available options:
signup.high_risk,
bulk.job_completed
high_risk_threshold
integer
default:75

Score threshold for signup.high_risk delivery.

Required range: 1 <= x <= 100
redact_email
boolean
default:false

Redact the email from the delivered payload.

Response

Webhook created (secret reveal-once).

webhook
object
required
metadata
object
required