v29

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

schedules

Update schedules

Update one or more schedules

patch/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

Entity ID.

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

Specify the entity type to get summary information

idstring required

namestring

Schedule name.

schedule_action'INCREASE_BY_VALUE' | 'INCREASE_BY_PERCENT'

The schedule action

schedule_idstring required

Schedule ID.

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"
    }
  }
]