Meta Ads

List the ad accounts the connected Meta user can access (id, name, status, currency, timezone, spend). Start here — every other tool takes an ad account id or an object id from it.

List the campaigns in a Meta ad account (objective, status, budgets, schedule, issues), optionally filtered by effective status.

Fetch one campaign: objective, statuses, buying type, bid strategy, budgets and remaining budget, schedule, special ad categories, delivery issues.

List ad sets — the budget / schedule / bidding / targeting layer — for an ad account or one campaign.

Fetch one ad set including its full targeting spec, optimization goal, billing event, bid, budgets and schedule.

List ads for an ad account, a campaign or an ad set (status, review state, creative summary, shareable preview link).

Fetch one ad: statuses, parent ad set / campaign, creative (with its object_story_spec), delivery issues, shareable preview link.

Performance insights for a whole ad account (impressions, clicks, spend, reach, ctr, cpc by default), optionally broken down per campaign / ad set / ad via `level`, by demographics or placement via `breakdowns`, and over time via `time_increment`.

Performance insights for one campaign (impressions, clicks, spend, reach, ctr, cpc by default; pass `fields` for actions / cost per result, `breakdowns` for age, gender, country, placement).

Performance insights for one ad set — the level at which targeting and budget decisions are judged.

Performance insights for one ad — compare creatives inside an ad set.

List the creatives in an ad account's library (name, status, object_story_spec, thumbnail) — reuse an existing creative_id in create_ad instead of making a duplicate.

Fetch one creative with its full object_story_spec, call to action, url tags and enhancement settings.

Render how a creative (or an ad's creative) looks in a placement. Returns Meta's preview iframe HTML — show it to a human before activating an ad.

List the Facebook Pages the connected user manages (id, name, category, tasks). A creative is published FROM a Page, so pick the page_id here first. Needs the pages_show_list permission (scope version 2+); a Page owned by a Business portfolio is listed only with business_management (scope version 3) and a role in that business. An empty first page carries a note on why.

List the images already uploaded to an ad account's library (hash, name, dimensions, temporary URL) — reuse a hash instead of re-uploading.

Search Meta's targeting taxonomy by text: interests (with audience size), geo locations (countries, regions, cities, zips with their keys) or locales. Feed the returned ids/keys into an ad set's targeting spec.

Browse a whole Meta targeting taxonomy (behaviors, demographics, life events, industries, income, family statuses, devices, OS) with ids and audience sizes.

Estimate the reachable audience (daily / monthly active users) for a targeting spec and optimization goal BEFORE creating an ad set — catch an empty or absurdly broad audience early.

Create a campaign (the objective + budget-strategy layer). Lands PAUSED unless status ACTIVE is passed. Give daily_budget or lifetime_budget here for Advantage campaign budget, or leave both off and budget each ad set instead (is_adset_budget_sharing_enabled then decides whether those ad set budgets may share, default false). Bills api_write.

Change a campaign's name, status, budget, bid strategy, spend cap or schedule. Only the fields given are changed. ACTIVE delivers, PAUSED stops reversibly; ARCHIVED retires it permanently (Meta lets an archived object move only to DELETED). Bills api_write.

Permanently delete a campaign and everything under it. To stop spend reversibly use update_campaign with status PAUSED; to retire it for good while keeping its reporting queryable use status ARCHIVED. Delete only what was created by mistake.

Create an ad set inside a campaign: targeting spec, optimization goal, billing event, bid, budget (unless the campaign carries it) and schedule. Lands PAUSED unless status ACTIVE is passed. Run estimate_audience on the targeting first. Bills api_write.

Change an ad set's status, budget, bid, targeting, schedule or optimization. Only the fields given are changed; a new targeting spec REPLACES the old one. PAUSED is reversible, ARCHIVED is permanent. Bills api_write.

Permanently delete an ad set and its ads. Use update_ad_set with status PAUSED to stop it reversibly, or ARCHIVED to retire it for good while keeping its reporting. Delete only what was created by mistake.

Upload an image (from a public https URL or a CoreSpeed Drive path or file id) to the ad account's image library and return its image_hash for create_ad_creative. JPG/PNG/GIF up to 30 MB; 1080×1080 or 1200×628 are the safe feed sizes. Bills api_write.

Create an image or video link creative published from a Page: primary text, headline, description, landing URL, call to action, url tags. Returns the creative_id for create_ad; preview it with get_ad_preview. Pass a full object_story_spec instead for carousels or other formats. Bills api_write.

Delete a creative from the library. Fails while an ad still uses it.

Create an ad by pairing a creative with an ad set. Lands PAUSED unless status ACTIVE is passed; Meta then reviews it (usually within 24h) before delivery starts. Bills api_write.

Rename an ad, pause or resume it, archive it permanently, or swap its creative (which re-enters review). Bills api_write.

Permanently delete an ad. Use update_ad with status PAUSED to stop it reversibly, or ARCHIVED to retire it for good while keeping its reporting.