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

# Ad set updated event

`POST ad_set.updated` (webhook)

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

### When it fires

Fires after the platform and Zernio both accepted the edit. Outside edits arrive up to one sync interval late, and only to the user whose sync saw them.

### Deduplication

Events are not deduplicated, so every edit is announced. Use the event `id` to drop repeats.

### Payload notes

`changes` lists the edited fields: `name`, `status` (the ad set's own on/off switch), `budget`, `bid`, `schedule`, `targeting` or `settings`. Ignore unknown values. It never carries old or new values, so read the ad set.

### What the sync detects

From the sync, `changes` covers only `name` and `status`. Status is not detected on Reddit.

### When it does not fire

History loaded when an account connects is never announced. Budget and targeting edits made through `PUT /v1/ads/{adId}` arrive as `ad.updated`.

## Payload

- WebhookPayloadAdSetUpdated: Webhook payload for the `ad_set.updated` event. Fires when an ad set is edited through Zernio (API, MCP or dashboard), after the platform and Zernio both accepted the edit, once per user who can see the ad set. It also fires when the sync detects an edit made outside Zernio. `source` is `zernio` for edits through Zernio, `platform` for edits the sync detected outside Zernio, up to one sync interval late, sent only to the user whose sync saw it. From the sync, `changes` covers only `name` and `status` (status not on Reddit). Never for history loaded when an account connects. `changes` names the edited fields and never their values: read the ad set with `GET /v1/ads/ad-sets/{adSetId}` for the current state. Ignore values you do not know, new ones can be added. Budget and targeting edits made through `PUT /v1/ads/{adId}` arrive as `ad.updated`. 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_set.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_SET', required: Always `AD_SET`.
    - `platformId` string, required: Platform-native ad set ID.
    - `platformAdAccountId` string, required: Platform-native ad account ID.
    - `name` string, nullable, required
    - `campaign` object, nullable, required: The campaign the ad set belongs to, or null when the platform has none.
      - `platformCampaignId` string, required
      - `name` string, nullable, required
  - `changes` string[], required: Fields edited by this request. `status` is the ad set'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)