Create a webhook subscription for recording-ready events; the signing secret is returned exactly once. Requires the webhooks:manage scope (PATs carry it implicitly) and paid-feature access. Also accepts an app session token (the settings UI).

post/v1/webhooks

Request

urlstring required

The https receiver URL to POST deliveries to.

eventsstring[] required

Event types to subscribe to (at least one).

team_idstring

Restrict to one team.

space_idstring

Restrict to one channel.

Created.

idstring required

The subscription id (wh_…).

urlstring required

The receiver URL deliveries are POSTed to.

eventsstring[] required

Subscribed event types.

team_idstring nullable required

Team scope, or null.

space_idstring nullable required

Channel scope, or null.

status'active' | 'disabled' required

Delivery status.

created_atstring required

Creation instant (ISO-8601 UTC).

last_success_atstring nullable required

Last successful delivery instant, or null.

last_failure_atstring nullable required

Last failed delivery instant, or null.

disabled_atstring nullable required

When disabled, or null.

disabled_reasonstring nullable required

Why disabled, or null.

secretstring required

The signing secret (whsec_…) for HMAC verification — returned ONCE.

No recorded changes to this operation across all 1 revision of this API.