Adbloop Meta Ads

create_campaign

Create ONE Meta campaign (created PAUSED for review). Free-plan friendly — counts toward your monthly campaign limit. To launch many at once or from a Drive folder, use bulk_create_campaigns (Pro). Needs a public imageUrl (or Drive/Dropbox share link) for image ads. WRITES live.

Input Schema

TableJSON Schema

Name	Required	Description
`appId`	No	App ID for App Promotion campaigns.
`useCBO`	No
`headline`	No
`imageUrl`	No	Image for the ad. Paste a PUBLIC https image URL, OR a single Google Drive / Dropbox file share link (shared so 'Anyone with the link can view') — these are auto-converted. For a single campaign, ask the user for ONE image's share link. (Listing a whole Drive folder to spin up one campaign per image is a Pro feature.)
`videoUrl`	No
`catalogId`	No
`cboBudget`	No
`countries`	No	ISO country codes; defaults to IN.
`ctaButton`	No
`objective`	Yes
`budgetType`	No	DAILY (default) or LIFETIME. LIFETIME needs lifetimeBudget and a scheduleEnd more than 24 hours after the start.
`leadFormId`	No	Instant-form ID for lead campaigns (instant_forms / website_and_instant_forms).
`websiteUrl`	No
`appStoreUrl`	No	App store URL for App Promotion campaigns.
`bidStrategy`	No	LOWEST_COST_WITHOUT_CAP / COST_CAP / LOWEST_COST_WITH_BID_CAP / LOWEST_COST_WITH_MIN_ROAS.
`dailyBudget`	No
`description`	No
`phoneNumber`	No	Phone number for Calls campaigns.
`primaryText`	No
`scheduleEnd`	No	Ad set end time, ISO 8601 datetime. Optional; when set, Meta stops the ad set at this time (auto-stop fail-safe). Required by Meta when a lifetime budget is used.
`campaignName`	Yes
`geoLocations`	No	OPTIONAL specific places instead of whole countries (replaces countries when set). Get keys from search_locations. cities: [{ key, radius (km, 17-80; omit for the city only), country_code }], regions: [{ key, country_code }] (states), zips: [{ key e.g. "IN:380015", country_code }] (PIN/ZIP codes). Meta rejects overlapping places (e.g. a PIN inside a city radius). With a Special Ad Category: no zips, and cities need a radius of at least 25 km.
`productSetId`	No
`scheduleStart`	No	Ad set start time, ISO 8601 datetime (e.g. 2026-09-20T09:00:00+08:00). Optional; defaults to ~1 hour from now.
`lifetimeBudget`	No	Total budget for the whole schedule in the account currency, MAJOR units (e.g. 150 = SGD 150). Used when budgetType is LIFETIME; Meta will not spend more than this in total.
`conversionEvent`	No	Pixel event for conversion goals, e.g. PURCHASE, LEAD, ADD_TO_CART.
`meta_account_id`	No	Ad account to create on (defaults to your primary).
`performanceGoal`	No
`specialAdCategory`	No	HOUSING / EMPLOYMENT / CREDIT / ISSUES_ELECTIONS_POLITICS (default NONE).
`conversionLocation`	No
`regionalRegulatedCategories`	No	Regional regulated category codes required for certain locations (e.g. ["SINGAPORE_UNIVERSAL"] for Singapore Employment ads). Passed through to the ad set.
`regionalRegulationIdentities`	No	Verified beneficiary/payer identity IDs, required together with regionalRegulatedCategories (e.g. { "singapore_universal_beneficiary": "<id>", "singapore_universal_payer": "<id>" }). Passed through to the ad set.

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 10, 2026

addedInput schema / properties / budgetType

Added value: +{
+  "description": "DAILY (default) or LIFETIME. LIFETIME needs lifetimeBudget and a scheduleEnd more than 24 hours after the start.",
+  "enum": [
+    "DAILY",
+    "LIFETIME"
+  ],
+  "type": "string"
+}

addedInput schema / properties / lifetimeBudget

Added value: +{
+  "description": "Total budget for the whole schedule in the account currency, MAJOR units (e.g. 150 = SGD 150). Used when budgetType is LIFETIME; Meta will not spend more than this in total.",
+  "type": "number"
+}

Changed1 schema field changedSep 30, 2026

addedInput schema / properties / geoLocations

Added value: +{
+  "additionalProperties": true,
+  "description": "OPTIONAL specific places instead of whole countries (replaces countries when set). Get keys from search_locations. cities: [{ key, radius (km, 17-80; omit for the city only), country_code }], regions: [{ key, country_code }] (states), zips: [{ key e.g. \"IN:380015\", country_code }] (PIN/ZIP codes). Meta rejects overlapping places (e.g. a PIN inside a city radius). With a Special Ad Category: no zips, and cities need a radius of at least 25 km.",
+  "properties": {
+    "cities": {
+      "items": {
+        "properties": {
+          "country_code": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string"
+          },
+          "radius": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "regions": {
+      "items": {
+        "properties": {
+          "country_code": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "zips": {
+      "items": {
+        "properties": {
+          "country_code": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

Changed2 schema fields changedSep 12, 2026

addedInput schema / properties / scheduleEnd

Added value: +{
+  "description": "Ad set end time, ISO 8601 datetime. Optional; when set, Meta stops the ad set at this time (auto-stop fail-safe). Required by Meta when a lifetime budget is used.",
+  "type": "string"
+}

addedInput schema / properties / scheduleStart

Added value: +{
+  "description": "Ad set start time, ISO 8601 datetime (e.g. 2026-09-20T09:00:00+08:00). Optional; defaults to ~1 hour from now.",
+  "type": "string"
+}

Changed2 schema fields changedSep 12, 2026

addedInput schema / properties / regionalRegulatedCategories

Added value: +{
+  "description": "Regional regulated category codes required for certain locations (e.g. [\"SINGAPORE_UNIVERSAL\"] for Singapore Employment ads). Passed through to the ad set.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / regionalRegulationIdentities

Added value: +{
+  "additionalProperties": true,
+  "description": "Verified beneficiary/payer identity IDs, required together with regionalRegulatedCategories (e.g. { \"singapore_universal_beneficiary\": \"<id>\", \"singapore_universal_payer\": \"<id>\" }). Passed through to the ad set.",
+  "type": "object"
+}

Changed10 schema fields changedAug 24, 2026

addedInput schema / properties / appId

Added value: +{
+  "description": "App ID for App Promotion campaigns.",
+  "type": "string"
+}

addedInput schema / properties / appStoreUrl

Added value: +{
+  "description": "App store URL for App Promotion campaigns.",
+  "type": "string"
+}

addedInput schema / properties / bidStrategy

Added value: +{
+  "description": "LOWEST_COST_WITHOUT_CAP / COST_CAP / LOWEST_COST_WITH_BID_CAP / LOWEST_COST_WITH_MIN_ROAS.",
+  "type": "string"
+}

addedInput schema / properties / catalogId
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / conversionEvent

Added value: +{
+  "description": "Pixel event for conversion goals, e.g. PURCHASE, LEAD, ADD_TO_CART.",
+  "type": "string"
+}

addedInput schema / properties / countries

Added value: +{
+  "description": "ISO country codes; defaults to IN.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / leadFormId

Added value: +{
+  "description": "Instant-form ID for lead campaigns (instant_forms / website_and_instant_forms).",
+  "type": "string"
+}

addedInput schema / properties / phoneNumber

Added value: +{
+  "description": "Phone number for Calls campaigns.",
+  "type": "string"
+}

addedInput schema / properties / productSetId
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / specialAdCategory

Added value: +{
+  "description": "HOUSING / EMPLOYMENT / CREDIT / ISSUES_ELECTIONS_POLITICS (default NONE).",
+  "type": "string"
+}

Changed1 schema field changedJun 18, 2026

addedInput schema / properties / imageUrl / description

Added value: +"Image for the ad. Paste a PUBLIC https image URL, OR a single Google Drive / Dropbox file share link (shared so 'Anyone with the link can view') — these are auto-converted. For a single campaign, ask the user for ONE image's share link. (Listing a whole Drive folder to spin up one campaign per image is a Pro feature.)"

AddedJun 8, 2026

TDQS

Score is being calculated.

All Adbloop Meta Ads tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?