Skip to content
Get MCP AdsGet MCP Ads, home
Start free

meta_create_adset

Create a PAUSED Meta ad set with explicit targeting, optimization, placements, attribution, bidding and schedule.

Create a PAUSED Meta ad set with explicit targeting, optimization, placements, attribution, bidding and schedule. Amounts use major account-currency units. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Source
Meta Ads
Kind
Write
Discovery
Reachable through search_tools and run_tool
Account parameter
adAccountId
Endpoint
https://mcp.getmcpads.com/meta-ads/mcp

ParametersLink to this section

NameTypeRequiredNotes
adAccountIdstringRequiredSelected owning ad account ID, with or without act_. Every referenced ad object must belong to it.
campaignIdstringRequiredNumeric ID of the parent campaign in the selected account. Its budget model and objective determine compatible ad set settings.
namestringRequiredExact business name to give this object. Do not derive it from an uploaded filename.
configurationobjectRequiredExplicit native Meta ad set settings. First read meta_get_adset_configuration for edits. A supplied targeting object replaces the entire targeting spec.
currencystringOptionalRequired with any monetary amount. Must match the actual account currency; never assume EUR.
dailyBudgetnumberOptionalDaily budget in major account-currency units, e.g. 10 means EUR 10. Cannot be combined with lifetimeBudget or a campaign-owned budget.
lifetimeBudgetnumberOptionalTotal lifetime budget in major account-currency units. Requires an end time; mutually exclusive with dailyBudget.
bidAmountnumberOptionalBid amount in major account-currency units. Only use with a compatible capped bidding strategy.
confirmbooleanOptionalApply only when true. Default is a local preview with no API mutation.
validateOnlybooleanOptionalAsk Meta to validate, without creating or changing an object. Mutually exclusive with confirm.

Calling itLink to this section

jsonThrough run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "meta_create_adset",
    "args": {
      "adAccountId": "<string>",
      "campaignId": "<string>",
      "name": "<string>",
      "configuration": "<object>"
    }
  }
}
Esc

Type to search