Webhooks

Outbound webhook subscriptions for lifecycle events

List a network's webhook subscriptions

Returns a cursor-paginated page of the network's webhook subscriptions, ordered by id; each shows its url, subscribed event types, and status (active or disabled). The signing secret is never included. Requires read access to the network.

Register a webhook subscription; the signing secret is returned ONCE

Registers an endpoint to receive push deliveries for the given lifecycle events. Valid event types are offer.accepted, offer.rejected, optin.completed, invitation.accepted, creative.ready, and creative.failed. The response carries a high-entropy signing secret returned only here (store it now); it keys the HMAC-SHA256 X-AdBridge-Signature on every delivery so you can verify authenticity. New subscriptions start active. Requires administrator access to the network.

Get a single webhook subscription

Fetches one webhook subscription, including its url, subscribed event types, and status. The signing secret is shown only once at creation and is never returned here. Requires read access to the network.

Delete a webhook subscription

Permanently removes the subscription so it stops receiving deliveries; to pause temporarily, update its status to disabled instead. The delete is optimistic-locked and returns 409 on a version conflict. Requires administrator access to the network.

Update a webhook's url, events, and/or status

Partially updates the subscription; supply any of url, events, or status (active or disabled) — at least one is required. Set status to disabled to pause deliveries without deleting the subscription. The signing secret cannot be changed or re-read. Writes are optimistic-locked and return 409 on a version conflict. Requires administrator access to the network.