---
title: "Campaign budget depleted event"
method: POST
path: "campaign.budget.depleted"
tags: ["Webhook Events"]
---

# Campaign budget depleted event

`POST campaign.budget.depleted` (webhook)

Fired when a campaign Zernio already tracked runs out of budget (TikTok).
See `WebhookPayloadCampaignBudgetDepleted` for when it fires and when it does not.

## Payload

- WebhookPayloadCampaignBudgetDepleted: Webhook payload for the `campaign.budget.depleted` event. Fires when a campaign Zernio already tracked stops delivering because its budget ran out. TikTok only: it is the one network that reports an exhausted budget on the ad. Meta and Google keep such ads `ACTIVE`, so they never fire it. Detected by Zernio's own ad sync. Each campaign fires at most once per 6 hours, so a daily budget that runs out again the next day is announced again.
  - `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). Present on every event tied to a profile and absent on events that belong to none. Events spanning several profiles (a post published to accounts of different profiles) list each once. Use it to route the event to your tenant without storing Zernio profile ids.
    - `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.budget.depleted', 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` 'CAMPAIGN', required: Always `CAMPAIGN`.
    - `platformId` string, required: Platform-native campaign ID.
    - `platformAdAccountId` string, required: Platform-native ad account ID.
    - `name` string, nullable, required
  - `budget` object, required
    - `raw` string, required: Platform-native status string, forwarded verbatim (TikTok `AD_STATUS_CAMPAIGN_EXCEED`).
  - `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/dadaad5046d4?raw)