---
title: "Schedule a budget increase"
method: POST
path: "/v1/ads/high-demand-periods"
tags: ["Ad Accounts"]
---

# Schedule a budget increase

`POST /v1/ads/high-demand-periods`

Pre-schedule a temporary budget increase (Black Friday, a launch, a sale) instead of
editing the budget by hand on the day. Same target rule as the GET: exactly one of
`campaignId` / `adSetId`.

Two Meta constraints worth knowing before you call it. `timeStart` / `timeEnd` must
fall on a 15-minute boundary, and a campaign cannot mix `ABSOLUTE` and `MULTIPLIER`
across its schedules — the second type is rejected with "Can't mix your budget scaling
selection". Window rules (must sit inside the campaign's run dates, minimum lead time,
no overlap) are Meta's and its message is forwarded verbatim.

## Request body

- object
  - `accountId` string, required — Zernio SocialAccount id used to resolve the Meta token.
  - `campaignId` string — Platform campaign id. Exactly one of campaignId / adSetId.
  - `adSetId` string — Platform ad set id. Exactly one of campaignId / adSetId.
  - `budgetValue` number, required — With ABSOLUTE, a budget in the ad account's currency in WHOLE units (50 = $50.00). With MULTIPLIER, a factor of the existing budget (2 = double it) and NOT a currency amount.
  - `budgetValueType` 'ABSOLUTE' | 'MULTIPLIER', required
  - `timeStart` integer, required — Unix seconds, on a 15-minute boundary (:00, :15, :30, :45).
  - `timeEnd` integer, required — Unix seconds, on a 15-minute boundary and after timeStart.
  - `recurrenceType` 'ONE_TIME' | 'WEEKLY' | 'MONTHLY'
  - `currency` string — Ad account currency, for the ABSOLUTE minor-unit conversion. Ignored for MULTIPLIER.

## Response `201`

Budget schedule created

- object
  - `objectId` string — The campaign / ad set the schedule was attached to.
  - `id` string — Meta budget schedule id.

## Other responses

- `400` — Invalid input, or Meta rejected the schedule
- `401` — Unauthorized
- `501` — Only supported on Meta (facebook/instagram)

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/15e893e69e8c/schema)