Skip to main content
POST
Create a Webhook Subscription

Authorizations

AccessToken
string
header
required

AWS Cognito access token obtained from the /authentication endpoint. Token expires after 3600 seconds.

Headers

Content-Type
string
required
Accept
string
required
AccessToken
string
required

Body

application/json
endpoint_url
string
required

Your HTTPS receiver URL. Must start with https://.

Example:

"https://hooks.yourapp.com/coverwhale"

event_types
enum<string>[]
required

One or more event types to receive. Must contain at least one.

Minimum array length: 1
Available options:
submission.quoted,
submission.bind_completed,
submission.endorsement_bound,
submission.renewed,
submission.pending_cancellation,
submission.canceled,
submission.reinstated,
submission.public_reply
Example:

Response

Subscription created — secret is included here only

id
integer
Example:

42

company_id
integer
Example:

6042

endpoint_url
string
Example:

"https://hooks.yourapp.com/coverwhale"

event_types
string[]
Example:
active
boolean
Example:

true

secret
string

Signing secret — shown only here and on rotate-secret.

Example:

"whsec_9f2c1e7a4b6d..."

secret_rotated_at
string<date-time> | null
Example:

null

created_at
string<date-time>
Example:

"2026-07-14T12:00:00+00:00"

updated_at
string<date-time>
Example:

"2026-07-14T12:00:00+00:00"