---
title: "Campaign status changed event"
method: POST
path: "campaign.status_changed"
tags: ["Webhook Events"]
---

# Campaign status changed event

`POST campaign.status_changed` (webhook)

A campaign Zernio already tracked changed its platform status or, on Google, the reasons behind it.

### When it fires

Fires when the ads sync reads a tracked campaign with a different status than it stored, up to one sync interval late. Covers every ad network.

### Status values

On Google, `status` is the campaign's `primary_status` (`ELIGIBLE`, `LIMITED`, `NOT_ELIGIBLE`, `PAUSED`, ...) and `reasons` its sorted `primary_status_reasons`, so a campaign turning budget limited fires. Elsewhere `status` is the campaign's own platform status (Meta `effective_status`) and `reasons` is empty.

### When it does not fire

A campaign seen for the first time, or the same change from the same previous status again within an hour (a retried sync). A change made through Zernio, such as a pause, fires on the next sync, once the sync reads it from the platform.

## Payload

- WebhookPayloadCampaignStatusChanged: Webhook payload for the `campaign.status_changed` event. Fires when the ads sync sees a campaign Zernio already tracked change its platform status or, on Google, its status reasons. `status` carries the platform's own values: Google's `primary_status` (`ELIGIBLE`, `LIMITED`, `NOT_ELIGIBLE`, `PAUSED`, ...), the campaign's own status on every other network (Meta `effective_status`: `ACTIVE`, `PAUSED`, `WITH_ISSUES`, ...). Never fires for a campaign seen for the first time. The same change (same previous and new status and reasons) fires at most once per campaign per hour. A change made through Zernio fires on the next sync.
  - `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` 'campaign.status_changed', 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
  - `campaign` object, required
    - `platformCampaignId` string, required: Platform-native campaign ID.
    - `name` string, nullable, required
  - `platform` string, required: The ad network, as the ads endpoints name it (`google`, `facebook`, `tiktok`, ...).
  - `adAccountId` string, required: Platform-native ad account ID.
  - `status` object, required
    - `previous` string, required: The platform's status before.
    - `current` string, required: The platform's status now.
  - `reasons` object, required: Google's `primary_status_reasons` (for example `BUDGET_CONSTRAINED`), sorted. Always empty on other networks.
    - `previous` string[], required
    - `current` string[], required
  - `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/980f5c976703?raw)
