Sign in

v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
schedules

Create schedules

Batch create schedules

post/ad_accounts/{ad_account_id}/schedules

Path parameters

ad_account_idstring required

Request body

end_timestampinteger

Schedule end time. Unix timestamp in seconds.

entity_idstring required

Entity ID.

entity_type'ADVERTISER' | 'CAMPAIGN' | 'AD_GROUP' | 'AD'

Specify the entity type to get summary information

namestring

Schedule name.

schedule_action'INCREASE_BY_VALUE' | 'INCREASE_BY_PERCENT'

The schedule action

schedule_status'DRAFT' | 'CREATED' | 'SCHEDULED' | 'ACTIVE' | 'COMPLETED' | 'FAILED' | 'CANCELED'

Schedule status

schedule_type'CAMPAIGN_BUDGET_CHANGE' | 'CAMPAIGN_BID_MULTIPLIERS'

The schedule type

start_timestampinteger

Schedule start time. Unix timestamp in seconds.

Example request

[
  {
    "entity_type": "CAMPAIGN",
    "schedule_action": "INCREASE_BY_VALUE",
    "schedule_status": "ACTIVE",
    "schedule_type": "CAMPAIGN_BUDGET_CHANGE"
  }
]

Response

The request has succeeded.

Example response

[
  {
    "data": {
      "entity_type": "CAMPAIGN",
      "schedule_action": "INCREASE_BY_VALUE",
      "schedule_status": "ACTIVE",
      "schedule_type": "CAMPAIGN_BUDGET_CHANGE"
    }
  }
]