WebhookCreateResponse

The response to creating a webhook. It carries the full WebhookDto plus the signing secret --- which is shown only here, on create. Subsequent reads (get/list) never return the secret, so the client must store it now; it cannot be recovered later.

webhook object

The created webhook

idstring

The webhook id

Example: 7Hb2Kp9QvL3mNx0R8tZ4

urlstring

The destination URL deliveries are POSTed to

Example: https://example.com/webhooks/adbridge

eventsstring[]

Subscribed event types

Possible values: [offer.accepted, offer.rejected, optin.completed, invitation.accepted, creative.ready, creative.failed]

statusstring

Subscription status

Possible values: [active, disabled]

Example: active

created_atdate-time

When the subscription was created

Example: 2026-01-15T09:30:00Z

updated_atdate-time

When the subscription was last updated

Example: 2026-01-15T09:30:00Z

secretstring

The signing secret (HMAC-SHA256 key). Shown ONLY on create — store it now; it cannot be retrieved again. Used to verify the X-AdBridge-Signature header on deliveries.

Example: whsec_xxxxxxxxxxxxxxxxxxxx

WebhookCreateResponse

{
  "webhook": {
    "id": "7Hb2Kp9QvL3mNx0R8tZ4",
    "url": "https://example.com/webhooks/adbridge",
    "events": [
      "offer.accepted"
    ],
    "status": "active",
    "created_at": "2026-01-15T09:30:00Z",
    "updated_at": "2026-01-15T09:30:00Z"
  },
  "secret": "whsec_xxxxxxxxxxxxxxxxxxxx"
}