---
title: "Ad updated event"
method: POST
path: "ad.updated"
tags: ["Webhook Events"]
---

# Ad updated event

`POST ad.updated` (webhook)

An ad was edited through Zernio (`source: "zernio"`), or outside Zernio and detected by the sync (`source: "platform"`).

### When it fires

Fires once, to the owner of the edited ad. Outside edits arrive up to one sync interval late. Every edit is announced, so use the event `id` to drop repeats.

### Payload notes

`changes` lists the edited fields: `name`, `status` (the ad's own on/off switch), `budget`, `targeting` or `creative`. Ignore unknown values; new ones can be added.

### Reading the change

The event never carries old or new values, so read the ad. `platformId` can change when a LinkedIn creative is replaced, while `adId` stays stable.

### When it does not fire

From the sync, `changes` covers only `name` and `status`. Budget, bid, schedule and targeting edits made outside Zernio, tracking tag edits and history loaded at connect are not announced. Ad rule changes arrive as `ad_rule.triggered`.

## Payload

- WebhookPayloadAdUpdated: Webhook payload for the `ad.updated` event. Fires when an ad is edited through Zernio (API, MCP or dashboard), after the platform and Zernio both accepted the edit, or when the sync detects an edit made outside Zernio. It is sent once, to the owner of the edited ad. `source` is `zernio` for edits through Zernio, `platform` for edits the sync detected outside Zernio, up to one sync interval late. From the sync, `changes` covers only `name` and `status`. Budget, bid, schedule and targeting edits made outside Zernio are not announced on the ad. Never for history loaded when an account connects. Tracking tag edits are not announced, and an ad rule that changes an ad arrives as `ad_rule.triggered`. `platformId` can change when a LinkedIn creative is replaced, while `adId` stays stable. `changes` names the edited fields and never their values: read the ad with `GET /v1/ads/{adId}` for the current state. Ignore values you do not know, new ones can be added. Events are not deduplicated: every edit is announced. Use the event `id` to drop repeats.
  - `id` string, required: Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery.
  - `profiles` object[]: The profiles this event belongs to, each with the externalId you set on it (null when none is set). Use it to route the event to your tenant without storing Zernio profile ids. Present on every event tied to a profile, absent on events that belong to none. Events spanning several profiles (a post published to accounts of different profiles) list each once.
    - `id` string, required
    - `externalId` string, nullable, required
  - `test` boolean: Always true when present: only a sample sent by POST /v1/webhooks/test with an event carries it. Real deliveries never do.
  - `event` 'ad.updated', required
  - `account` WebhookAdsAccount, required: The connected ads account the event belongs to.
    - `accountId` string, required: Internal Zernio account ID (same as used in /v1/accounts/{accountId}).
    - `profileId` string, required: Internal Zernio profile ID this account belongs to.
    - `platform` string, required: Ads connection platform (`metaads`, `googleads`, `tiktokads`, `linkedinads`, `pinterestads`, `xads`, ...).
    - `username` string, required
    - `displayName` string, nullable
  - `adObject` object, required
    - `level` 'AD', required: Always `AD`.
    - `platformId` string, required: Platform-native ad ID.
    - `platformAdAccountId` string, required: Platform-native ad account ID.
    - `adId` string, required: Zernio ad ID, usable with GET /v1/ads/{adId}.
    - `name` string, required
    - `campaign` object, nullable, required: The campaign the ad belongs to, or null when the platform has none.
      - `platformCampaignId` string, required
      - `name` string, nullable, required
    - `adSet` object, nullable, required: The ad set the ad belongs to, or null when the platform has none.
      - `platformAdSetId` string, required
      - `name` string, nullable, required
  - `changes` string[], required: Fields edited by this request. `status` is the ad's own on/off switch. Ignore values you do not know.
  - `source` 'zernio' | 'platform', required: Where the edit was made. `zernio` for edits through Zernio, `platform` for edits the sync detected outside Zernio.
  - `timestamp` string, date-time, required: UTC time at which Zernio generated this event.

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/a79c233ebf22?raw)