API Reference

Meta Ads / API Reference

meta_ads_create_adset_with_dayparting

Meta Ads tool. Create an ad set with dayparting (scheduled delivery by hour/day). NOTE: Dayparting REQUIRES lifetime_budget — daily budget does not support scheduling. Args: name: Ad set name (required). campaign_id: Campaign ID (required). lifetime_budget: Total budget in smallest currency unit, e.g. 100000 = ₪1000 (required). start_time: Campaign start ISO datetime, e.g. '2026-04-01T00:00:00+0300' (required). end_time: Campaign end ISO datetime (required). schedule: JSON array of day-part windows. Each entry: {"start_minute": 540, "end_minute": 1080, "days": [1,2,3,4,5]} start/end_minute = minutes after midnight (must be multiples of 30). days: 0=Sun, 1=Mon, 2=Tue, 3=Wed, 4=Thu, 5=Fri, 6=Sat. (required) Example (Mon-Fri 9AM-6PM): '[{"start_minute":540,"end_minute":1080,"days":[1,2,3,4,5]}]' optimization_goal: Default OFFSITE_CONVERSIONS. billing_event: Default IMPRESSIONS. targeting: JSON targeting spec string. Leave blank for broad targeting. bid_amount: Bid cap in smallest currency unit. 0 = auto bid. account_id: Ad account ID. Leave blank for .env default.

This is a write tool: it creates adset with dayparting in your Meta Ads account. Claude asks you to confirm before it runs.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Create adset with dayparting in my Meta Ads account for [name], [campaign id], [lifetime budget].

It takes 6 required and 5 optional parameters.

Parameters

ParameterTypeRequiredDescription
namestringYesName
campaign_idstringYesCampaign Id
lifetime_budgetintegerYesLifetime Budget
start_timestringYesStart Time
end_timestringYesEnd Time
schedulestringYesSchedule
optimization_goalstringNoOptimization Goal
billing_eventstringNoBilling Event
targetingstringNoTargeting
bid_amountintegerNoBid Amount
account_idstringNoAccount Id

Related Meta Ads tools

Before you can call it

This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads