Marketing API
Graph API Version

Campaign Budget Schedules

Budget scheduling allows you to schedule budget increases for your campaign or ad set budget based on days or times when you anticipate higher sales opportunities, peak traffic periods or other promotional time periods. You can find additional information in the Meta Business Help Center and in the About budget scheduling section

Reading

You can't perform this operation on this endpoint.

Creating

You can make a POST request to budget_schedules edge from the following paths:
When posting to this edge, no Graph object will be created.

Parameters

ParameterDescription
budget_value
int64

Amount of budget increase during the high demand period. Can be expressed in either an absolute amount, or a multiplier value. The type is specified through the budget value type.

Required
budget_value_type
enum{ABSOLUTE, MULTIPLIER}

Type of budget value. This sets if the specified budget value is an increase by an absolute amount or by a multiplier value.

Required
time_end
int64

Time when the high demand period should end.

Required
time_start
int64

Time when the high demand period should start.

Required

Return Type

This endpoint supports read-after-write and will read the node represented by id in the return type.
Struct {
id: numeric string,
}

Error Codes

ErrorDescription
100Invalid parameter

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.