Skip to main content
Glama

Create Campaign

adsap_create_campaign

Create Meta campaign. Defaults to PAUSED — only set ACTIVE when explicitly requested. For Catalog or Collection ads, set advantage_catalog_ads: true + catalog_id (OUTCOME_SALES only): Meta binds the catalog at the CAMPAIGN level, so a plain sales campaign cannot host those formats and the ad create will fail later. The ad set needs no catalog fields, and the product set is chosen per ad. ALWAYS call with dry_run: true first: it validates and renders a launch review card where the user confirms, creates (paused) and activates in-card — after it renders, reply with ONE short sentence and stop. Do not call the real create from chat unless the user explicitly asks in a new message and the card's activity log shows nothing was created there.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameYes
statusNoPAUSED
dry_runNoValidate only, no creation
objectiveYes
spend_capNoIn cents
stop_timeNoRequired with lifetime_budget
catalog_idNoMeta product catalog id to bind to the campaign. Required when advantage_catalog_ads is true, ignored otherwise. Get ids from adsap_list_catalogs. The product SET is chosen later per ad, not here.
start_timeNoRequired with lifetime_budget
buying_typeNoAUCTION
bid_strategyNoCampaign-level bid strategy. Only applied under CBO (campaign_budget_optimization: true) or when share_budget_with_ad_sets is true (budget sharing requires a campaign bid strategy — Meta error 4834005); ignored for plain ad-set-budget campaigns. Cap and ROAS values are set per ad set via adsap_create_ad_sets (bid_amount / roas_target), not at the campaign level. Defaults to LOWEST_COST_WITHOUT_CAP.
daily_budgetNoIn cents. Mutually exclusive with lifetime_budget.
ad_account_idYes
idempotency_keyNo
lifetime_budgetNoIn cents. Mutually exclusive with daily_budget.
promoted_objectNoOUTCOME_APP_PROMOTION + iOS apps ONLY: campaign-level app binding for iOS/SKAdNetwork campaigns (is_skadnetwork_attribution is set automatically). Meta treats any campaign with a campaign-level promoted_object as an iOS-14 SKAN campaign — Android apps are rejected there (2446632), so for Android pass the app on the ad set instead; Android values here are ignored. The app must be in Live mode and advertisable by the ad account.
advantage_catalog_adsNoEnable Advantage+ Catalog Ads (catalog-based advertising). OUTCOME_SALES only, and requires catalog_id. REQUIRED for any campaign that will host Catalog or Collection ads: Meta binds the catalog at the CAMPAIGN level, so a plain sales campaign cannot host them. Mirrors the web UI's Advantage+ Catalog Ads switch.
special_ad_categoriesNoMeta Special Ad Category. Required for ads about financial products and services (FINANCIAL_PRODUCTS_SERVICES; CREDIT is the retired name), employment, housing, social issues/elections/politics, or online gambling and gaming. Housing, employment and financial categories lock ad set targeting to 18-65+, all genders and a 15 mi / 25 km radius floor; the other two only confine ad set locations to special_ad_category_country. ONLINE_GAMBLING_AND_GAMING also needs Meta's gambling authorization on the ad account.
share_budget_with_ad_setsNoCampaign-level toggle for Meta's "Share some of your budget with other ad sets" (is_adset_budget_sharing_enabled). Only valid on ABO campaigns (no campaign-level budget) whose ad sets use DAILY budgets; rejected on CBO campaigns (Meta error 4834002). Worth considering for ABO campaigns with multiple ad sets. Defaults to false (off) when omitted.
special_ad_category_countryNoISO country codes, one or several. Required when special_ad_categories is set; ad sets under the campaign must target inside this list.
campaign_budget_optimizationNoEnable CBO

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full disclosure burden, and it meets it admirably. It reveals the default PAUSED state, the dry-run validation and launch-review-card flow, the user-confirmation requirement, the catalog-binding behavior at the campaign level, and the conversational stop rule after the card renders. This is highly transparent about how the tool actually behaves and what side effects or UI steps to expect.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core purpose and then packs dense, non-obvious guidance into a compact block. Every sentence earns its place: the default status, the catalog-ads constraint, the dry-run card workflow, and the stop-and-wait rule. For a tool with 20 parameters and no annotations, this level of focused detail is appropriately sized.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity, the absence of annotations, and the lack of an output schema, the description covers the most decision-critical context: the interactive launch flow, the defaulting behavior, and the catalog requirement. It does not describe the exact shape or contents of the launch-review card or the real-create response, but the schema absorbs most parameter-level detail. A small but non-fatal gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 70%, so much parameter-level detail already exists. The description adds valuable cross-parameter semantics: the PAUSED default and ACTIVE exception, the requirement to pair advantage_catalog_ads with catalog_id for Catalog/Collection ads, the fact that the ad set needs no catalog fields while the product set is chosen at the ad level, and the dry_run-first workflow. This goes beyond what individual schema descriptions convey, though it does not comment on all parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with 'Create Meta campaign' — a specific verb, platform, and resource — making it immediately clear what the tool does. It also distinguishes itself from Google campaign siblings by saying 'Meta', and from adsap_create_ad and adsap_create_ad_sets by naming the campaign resource. The added context about defaulting to PAUSED reinforces the core behavior.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit operational directives: ALWAYS call with dry_run: true first, rely on the rendered launch review card, and do not call the real create from chat unless the user explicitly asks in a new message and the card's activity log shows nothing was created. These are strong when-to-use and when-not-to-use instructions. However, it never names sibling tools like adsap_create_ad_sets or adsap_create_ad as the alternatives for creating ad sets or ads, so the versus-alternatives guidance is only implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources