Create a Webhook Subscription
Register an HTTPS endpoint to receive events for your account’s submissions. The signing secret is returned only in this response (and on rotate-secret) — store it now; it is never shown again. Use it to verify the signature on every delivery.
Subscriptions are scoped to your account: you only ever receive events for submissions your company owns.
Authorizations
AWS Cognito access token obtained from the /authentication endpoint. Token expires after 3600 seconds.
Body
Your HTTPS receiver URL. Must start with https://.
"https://hooks.yourapp.com/coverwhale"
One or more event types to receive. Must contain at least one.
1submission.quoted, submission.bind_completed, submission.endorsement_bound, submission.renewed, submission.pending_cancellation, submission.canceled, submission.reinstated, submission.public_reply Response
Subscription created — secret is included here only
42
6042
"https://hooks.yourapp.com/coverwhale"
true
Signing secret — shown only here and on rotate-secret.
"whsec_9f2c1e7a4b6d..."
null
"2026-07-14T12:00:00+00:00"
"2026-07-14T12:00:00+00:00"