ad.approved

Event type: ad.approved.

When it fires

An ad passed the platform's review and is live or scheduled.

Envelope

Every event shares these top-level fields. The event-specific fields are under data.

Field	Type	Required	Description
`id`	`string`	Yes	Unique event id. Deliveries are at-least-once, so dedupe on it.
`type`	`"ad.approved"`	Yes
`createdAt`	`string (date-time)`	Yes
`apiVersion`	`"v1"`	Yes
`organizationId`	`integer`	Yes
`brandId`	`integer \| null`	Yes
`accountId`	`string \| null`	Yes	The ad account the event concerns.
`provider`	`string \| null`	Yes	The ad platform the event happened on. One of `meta`, `whop`.

Data

Field	Type	Required	Description
`data.ad`	`object`	Yes
`data.ad.providerId`	`string`	Yes	The ad platform's ad id.
`data.ad.koastId`	`string \| null`	Yes
`data.ad.name`	`string \| null`	Yes
`data.ad.adSetProviderId`	`string \| null`	Yes
`data.ad.campaignProviderId`	`string \| null`	Yes
`data.ad.campaignLaunchId`	`string \| null`	Yes	The Koast launch the ad came from, when it came from one.
`data.previousStatus`	`string \| null`	Yes	Delivery status as Koast displays it. One of `LIVE`, `OFF`, `UNDER_REVIEW`, `REJECTED`, `SCHEDULED`, `PROCESSING`, `NOT_DELIVERING`, `DRAFT`.
`data.providerStatus`	`string \| null`	Yes	The ad platform's own review status string, unmapped.
`data.changedAt`	`string (date-time)`	Yes

Example payload

{
  "id": "evt_2xKq7Vb9mN4pR8sT",
  "type": "ad.approved",
  "createdAt": "2026-09-19T14:30:00Z",
  "apiVersion": "v1",
  "organizationId": 1,
  "brandId": 1,
  "accountId": "string",
  "provider": "meta",
  "data": {
    "ad": {
      "providerId": "string",
      "koastId": "string",
      "name": "string",
      "adSetProviderId": "string",
      "campaignProviderId": "string",
      "campaignLaunchId": "string"
    },
    "previousStatus": "LIVE",
    "providerStatus": "string",
    "changedAt": "2026-09-19T14:30:00Z"
  }
}

Delivery headers

Header	Required	Description
`webhook-id`	Yes	The delivery id; identical across retries of the same event. Dedupe on the envelope `id`.
`webhook-timestamp`	Yes	Unix seconds at signing time. Reject deliveries older than 5 minutes.
`webhook-signature`	Yes	Space-separated `v1,<base64 HMAC-SHA256>` signatures (Standard Webhooks). Two are sent while a rotated secret overlaps.

Acknowledge

Your response	Meaning
`2XX`	Return any 2xx status to acknowledge the delivery.

Signing, retries and endpoint setup are in the Webhooks guide.