account | DynamicAccount | Yes | - | Select Meta Ads account, ask the user for it if not provided |
adset_id | string or SelectItem | Yes | - | The ad set to update the schedule for |
start_time | integer or string | No | - | New start time: Unix seconds, YYYY-MM-DD, or an ISO datetime such as 2026-10-01 09:00 (UTC). Leave empty to keep current start time. Only editable while the ad set has not started delivering yet. |
end_time | integer or string | No | - | New end time: Unix seconds, YYYY-MM-DD, or an ISO datetime such as 2026-10-31 23:59 (UTC). Leave empty to keep current end time. Required for ad sets using a lifetime budget. Must be after start_time. Meta keeps schedules on ad sets only: a campaign’s end date is the latest end_time of its ad sets, so to extend a campaign update every ad set in it. |
clear_end_time | boolean | No | False | Set to true to remove the end time entirely (run the ad set with no end date). Only allowed for ad sets on a daily budget; lifetime-budget ad sets require an end_time. When true, end_time is ignored. |