Webhook Events

Ad created event

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

When it fires

Fires once the ad's campaign and ad set are recorded. A detected ad arrives up to one sync interval late; Meta ads entering review usually arrive within minutes.

When it does not fire

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

postWebhookad.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.created' required

source'zernio' | 'platform' required

Where the ad was created. zernio for ads created through Zernio, platform for ads 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.