Webhook Events

Ad video processed event

Fired once per POST /v1/ads/videos call made with async: true, when Meta finishes processing the uploaded video. video.status is ready (reference it as video.id on the create endpoints) or error (Meta could not process it; video.error carries the reason).

Zernio watches the video for up to about 13 minutes after the upload request. A video still processing after that sends no event, so keep GET /v1/ads/videos/{videoId} as the source of truth for long videos.

postWebhookad.video.processed

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.

event'ad.video.processed' required

timestampstring date-time required

UTC time at which Zernio generated this event.

Example payload

{
  "account": {
    "platform": "metaads"
  }
}

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.