Ad Accounts

Schedule a budget increase

Changed on

Schedules a temporary budget increase on a Meta campaign or ad set for a busy period, like Black Friday or a launch.

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.

post/v1/ads/high-demand-periods

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/high-demand-periods
  • Auth: HTTP bearer

Request body

accountIdstring required

Zernio SocialAccount id used to resolve the Meta token.

campaignIdstring

Platform campaign id. Exactly one of campaignId / adSetId.

adSetIdstring

Platform ad set id. Exactly one of campaignId / adSetId.

budgetValuenumber 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
timeStartinteger required

Unix seconds, on a 15-minute boundary (:00, :15, :30, :45).

timeEndinteger required

Unix seconds, on a 15-minute boundary and after timeStart.

recurrenceType'ONE_TIME' | 'WEEKLY' | 'MONTHLY'
currencystring

Ad account currency, for the ABSOLUTE minor-unit conversion. Ignored for MULTIPLIER.

Response

Budget schedule created

objectIdstring

The campaign / ad set the schedule was attached to.

idstring

Meta budget schedule id.

Changes

  • 450ec6ec5b0eRevision changes
    • info

      added the non-success response with the status

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status