Webhook Events

Ad set created event

An ad set was created through Zernio (source: "zernio") or detected by the sync (source: "platform").

When it fires

Fires once the ad set row is recorded, so GET /v1/ads/ad-sets/{adSetId} finds it. A detected ad set arrives up to one sync interval late.

Payload notes

adObject.campaign is the campaign the ad set belongs to, or null when the platform has none.

When it does not fire

History loaded when an account connects, and ad sets created more than 7 days ago, are never announced.

postWebhookad_set.created

Payload

idstring required

Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery.

testboolean

Always true when present: only a sample sent by POST /v1/webhooks/test with an event carries it. Real deliveries never do.

event'ad_set.created' required
source'zernio' | 'platform' required

Where the ad set was created. zernio for ad sets created through Zernio, platform for ad sets the sync detected.

timestampstring date-time required

UTC time at which Zernio generated this event.

Example payload

{
  "profiles": [
    {
      "externalId": "tenant_42"
    }
  ],
  "account": {
    "platform": "tiktokads"
  }
}

Response

Webhook received successfully

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.