OIP system: Meta Ads
A generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.
This page is the operating article for one build subsystem. It is generated from live directory rows. If a task belongs to this subsystem, scan the operations below, open the matching capability article, run only the exact object named there, and verify by receipt.
Kind: api. Capabilities: 52. Machine system map: /api/dispatch?map=META&format=markdown. Root: /a/oip.
Operations
META
Meta Graph API unified entrypoint (Marketing API) Use when: Meta ad accounts, campaigns, adsets, ads, creatives, insights, CAPI Arguments: $1=op, $2..$N=args per op. Human article: /a/oip-capability-meta. Machine doc: ?key=META&format=markdown. Invocation history: /api/invocations?object_id=META.
META_CAPI_EVENT
Invokable OIP capability. Use when: per browser-side conversion event that needs to be mirrored to Meta CAPI server-side. Human article: /a/oip-capability-meta-capi-event. Machine doc: ?key=META_CAPI_EVENT&format=markdown. Invocation history: /api/invocations?object_id=META_CAPI_EVENT.
META_SYNC_BACKFILL
Trigger lbl meta insights backfill. Ledgered. Human article: /a/oip-capability-meta-sync-backfill. Machine doc: ?key=META_SYNC_BACKFILL&format=markdown. Invocation history: /api/invocations?object_id=META_SYNC_BACKFILL.
META_ACCOUNTS
Live Meta ad accounts via the loop-meta-bridge service binding. Lists every owned/authorized account and upserts them into meta_ad_accounts so the marketing surface + Site Sync stay current. Read-only; never spends. Use when: "what ad accounts do I have", "sync my meta accounts", refresh the ad-account list. Arguments: none.. Human article: /a/oip-capability-meta-accounts. Machine doc: ?key=META_ACCOUNTS&format=markdown. Invocation history: /api/invocations?object_id=META_ACCOUNTS.
META_INSIGHTS
Per-account Meta performance (spend, impressions, clicks, purchases, ROAS) for a date preset, via the loop-meta-bridge. Read-only. Use when: "how are my ads doing", "meta spend this week", reconcile ad spend against sales. Arguments: $1 = date preset (today|yesterday|last_7d|last_14d|last_30d|last_90d, default last_7d). $2 = optional comma-separated act_ ids.. Human article: /a/oip-capability-meta-insights. Machine doc: ?key=META_INSIGHTS&format=markdown. Invocation history: /api/invocations?object_id=META_INSIGHTS.
META_HEALTH
Bridge + token health — confirms the Meta token is bound and does a live /me ping. Surfaces permission errors (e.g. missing ads_read) plainly. Use when: "is meta connected", debugging why insights are empty. Arguments: none.. Human article: /a/oip-capability-meta-health. Machine doc: ?key=META_HEALTH&format=markdown. Invocation history: /api/invocations?object_id=META_HEALTH.
META_ADS_ACCOUNTS
List all ad accounts (owned + client + authorized) with status, currency, spend. Arguments: JSON {} (no args).. Human article: /a/oip-capability-meta-ads-accounts. Machine doc: ?key=META_ADS_ACCOUNTS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_ACCOUNTS.
META_ADS_ACCOUNT_GET
Get one ad account: status, currency, spend, balance, spend_cap, funding, capabilities. Arguments: JSON {account_id}.. Human article: /a/oip-capability-meta-ads-account-get. Machine doc: ?key=META_ADS_ACCOUNT_GET&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_ACCOUNT_GET.
META_ADS_CAMPAIGNS
List campaigns in an ad account (id,name,status,objective,budgets,times). Arguments: JSON {account_id}.. Human article: /a/oip-capability-meta-ads-campaigns. Machine doc: ?key=META_ADS_CAMPAIGNS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CAMPAIGNS.
META_ADS_ADSETS
List ad sets in an ad account (id,name,status,budget,campaign_id,effective_status). Arguments: JSON {account_id}.. Human article: /a/oip-capability-meta-ads-adsets. Machine doc: ?key=META_ADS_ADSETS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_ADSETS.
META_ADS_ADS
List ads in an ad account (id,name,status,effective_status,adset_id,campaign_id,creative). Arguments: JSON {account_id}.. Human article: /a/oip-capability-meta-ads-ads. Machine doc: ?key=META_ADS_ADS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_ADS.
META_ADS_CREATIVES
List ad creatives (title,body,image_url,object_story_spec,cta,link). Arguments: JSON {account_id}.. Human article: /a/oip-capability-meta-ads-creatives. Machine doc: ?key=META_ADS_CREATIVES&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CREATIVES.
META_ADS_IMAGES
List ad images (name,url,hash,dimensions). Arguments: JSON {account_id}.. Human article: /a/oip-capability-meta-ads-images. Machine doc: ?key=META_ADS_IMAGES&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_IMAGES.
META_ADS_VIDEOS
List ad videos (title,description,length,thumbnails). Arguments: JSON {account_id}.. Human article: /a/oip-capability-meta-ads-videos. Machine doc: ?key=META_ADS_VIDEOS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_VIDEOS.
META_ADS_OBJECT_GET
Get any Graph node by id with a fields list. Arguments: JSON {id, fields?}.. Human article: /a/oip-capability-meta-ads-object-get. Machine doc: ?key=META_ADS_OBJECT_GET&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_OBJECT_GET.
META_ADS_INSIGHTS
Comprehensive reporting: insights at account/campaign/adset/ad level with fields, breakdowns, date_preset or time_range, attribution windows, filtering. Arguments: JSON {object_id|account_id, level?, fields?, breakdowns?, date_preset?, time_range?, time_increment?, action_attribution_windows?, filtering?}.. Human article: /a/oip-capability-meta-ads-insights. Machine doc: ?key=META_ADS_INSIGHTS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_INSIGHTS.
META_ADS_INSIGHTS_ASYNC_CREATE
Start an async insights report job (large pulls). Arguments: JSON {object_id|account_id, level?, fields?, breakdowns?, date_preset?|time_range?}.. Human article: /a/oip-capability-meta-ads-insights-async-create. Machine doc: ?key=META_ADS_INSIGHTS_ASYNC_CREATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_INSIGHTS_ASYNC_CREATE.
META_ADS_INSIGHTS_ASYNC_STATUS
Poll an async insights report job. Arguments: JSON {report_run_id}.. Human article: /a/oip-capability-meta-ads-insights-async-status. Machine doc: ?key=META_ADS_INSIGHTS_ASYNC_STATUS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_INSIGHTS_ASYNC_STATUS.
META_ADS_INSIGHTS_ASYNC_RESULT
Read a completed async insights report. Arguments: JSON {report_run_id}.. Human article: /a/oip-capability-meta-ads-insights-async-result. Machine doc: ?key=META_ADS_INSIGHTS_ASYNC_RESULT&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_INSIGHTS_ASYNC_RESULT.
META_ADS_TARGETING_SEARCH
Search targeting: interests, behaviors, demographics, employers, schools. Arguments: JSON {q, type?, class?, limit?}.. Human article: /a/oip-capability-meta-ads-targeting-search. Machine doc: ?key=META_ADS_TARGETING_SEARCH&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_TARGETING_SEARCH.
META_ADS_TARGETING_BROWSE
Browse the targeting interest taxonomy. Arguments: JSON {limit?}.. Human article: /a/oip-capability-meta-ads-targeting-browse. Machine doc: ?key=META_ADS_TARGETING_BROWSE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_TARGETING_BROWSE.
META_ADS_DELIVERY_ESTIMATE
Estimated daily reach for a targeting spec + optimization goal. Arguments: JSON {account_id, optimization_goal, targeting_spec}.. Human article: /a/oip-capability-meta-ads-delivery-estimate. Machine doc: ?key=META_ADS_DELIVERY_ESTIMATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_DELIVERY_ESTIMATE.
META_ADS_CATALOGS
List product catalogs on the business. Arguments: JSON {} (no args).. Human article: /a/oip-capability-meta-ads-catalogs. Machine doc: ?key=META_ADS_CATALOGS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CATALOGS.
META_ADS_CATALOG_GET
Get a product catalog (product_count, vertical, feed_count). Arguments: JSON {catalog_id}.. Human article: /a/oip-capability-meta-ads-catalog-get. Machine doc: ?key=META_ADS_CATALOG_GET&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CATALOG_GET.
META_ADS_CATALOG_PRODUCTS
List products in a catalog (retailer_id,availability,price,review_status,visibility). Arguments: JSON {catalog_id}.. Human article: /a/oip-capability-meta-ads-catalog-products. Machine doc: ?key=META_ADS_CATALOG_PRODUCTS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CATALOG_PRODUCTS.
META_ADS_CATALOG_PRODUCT_SETS
List product sets in a catalog. Arguments: JSON {catalog_id}.. Human article: /a/oip-capability-meta-ads-catalog-product-sets. Machine doc: ?key=META_ADS_CATALOG_PRODUCT_SETS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CATALOG_PRODUCT_SETS.
META_ADS_CATALOG_FEEDS
List data feeds in a catalog (schedule, latest_upload). Arguments: JSON {catalog_id}.. Human article: /a/oip-capability-meta-ads-catalog-feeds. Machine doc: ?key=META_ADS_CATALOG_FEEDS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CATALOG_FEEDS.
META_ADS_CATALOG_DIAGNOSTICS
Catalog diagnostics: data feed and item visibility issues. Arguments: JSON {catalog_id}.. Human article: /a/oip-capability-meta-ads-catalog-diagnostics. Machine doc: ?key=META_ADS_CATALOG_DIAGNOSTICS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CATALOG_DIAGNOSTICS.
META_ADS_PIXELS
List ad account pixels/datasets (last_fired_time, availability, matching). Arguments: JSON {account_id}.. Human article: /a/oip-capability-meta-ads-pixels. Machine doc: ?key=META_ADS_PIXELS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_PIXELS.
META_ADS_DATASET_STATS
Signal health/quality stats for a pixel/dataset. Arguments: JSON {pixel_id}.. Human article: /a/oip-capability-meta-ads-dataset-stats. Machine doc: ?key=META_ADS_DATASET_STATS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_DATASET_STATS.
META_ADS_AUDIENCES
List custom audiences (subtype, size, operation_status). Arguments: JSON {account_id}.. Human article: /a/oip-capability-meta-ads-audiences. Machine doc: ?key=META_ADS_AUDIENCES&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_AUDIENCES.
META_ADS_STUDIES
List A/B tests and conversion-lift studies on the business. Arguments: JSON {} (no args).. Human article: /a/oip-capability-meta-ads-studies. Machine doc: ?key=META_ADS_STUDIES&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_STUDIES.
META_ADS_STUDY_GET
Get an A/B test / lift study (cells, objectives, status). Arguments: JSON {study_id}.. Human article: /a/oip-capability-meta-ads-study-get. Machine doc: ?key=META_ADS_STUDY_GET&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_STUDY_GET.
META_ADS_ACTIVITIES
Activity log for an ad account (Ads Manager change history). Arguments: JSON {account_id, limit?}.. Human article: /a/oip-capability-meta-ads-activities. Machine doc: ?key=META_ADS_ACTIVITIES&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_ACTIVITIES.
META_ADS_MCP_TOOLS
List every tool exposed by Metas hosted Ads MCP server (live proxy to mcp.facebook.com/ads). Arguments: JSON {} (no args).. Human article: /a/oip-capability-meta-ads-mcp-tools. Machine doc: ?key=META_ADS_MCP_TOOLS&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_MCP_TOOLS.
META_ADS_CAMPAIGN_CREATE
Create a campaign (defaults status PAUSED so it does not spend until activated). Arguments: JSON {account_id, name, objective, status?, special_ad_categories?, buying_type?, bid_strategy?, daily_budget?, lifetime_budget?}.. Human article: /a/oip-capability-meta-ads-campaign-create. Machine doc: ?key=META_ADS_CAMPAIGN_CREATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CAMPAIGN_CREATE.
META_ADS_CAMPAIGN_UPDATE
Update a campaign (name, status, budget, bid_strategy). Arguments: JSON {campaign_id|id, params:{...}}.. Human article: /a/oip-capability-meta-ads-campaign-update. Machine doc: ?key=META_ADS_CAMPAIGN_UPDATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CAMPAIGN_UPDATE.
META_ADS_ADSET_CREATE
Create an ad set (defaults status PAUSED). Arguments: JSON {account_id, name, campaign_id, optimization_goal, billing_event, daily_budget?|lifetime_budget?, targeting?, bid_amount?, promoted_object?, start_time?, end_time?}.. Human article: /a/oip-capability-meta-ads-adset-create. Machine doc: ?key=META_ADS_ADSET_CREATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_ADSET_CREATE.
META_ADS_ADSET_UPDATE
Update an ad set (status, budget, targeting, bid). Arguments: JSON {adset_id|id, params:{...}}.. Human article: /a/oip-capability-meta-ads-adset-update. Machine doc: ?key=META_ADS_ADSET_UPDATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_ADSET_UPDATE.
META_ADS_AD_CREATE
Create an ad (defaults status PAUSED). Arguments: JSON {account_id, name, adset_id, creative:{creative_id}}.. Human article: /a/oip-capability-meta-ads-ad-create. Machine doc: ?key=META_ADS_AD_CREATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_AD_CREATE.
META_ADS_AD_UPDATE
Update an ad (status, creative, name). Arguments: JSON {ad_id|id, params:{...}}.. Human article: /a/oip-capability-meta-ads-ad-update. Machine doc: ?key=META_ADS_AD_UPDATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_AD_UPDATE.
META_ADS_CREATIVE_CREATE
Create an ad creative. Arguments: JSON {account_id, name, object_story_spec|object_story_id|asset_feed_spec}.. Human article: /a/oip-capability-meta-ads-creative-create. Machine doc: ?key=META_ADS_CREATIVE_CREATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CREATIVE_CREATE.
META_ADS_STATUS_SET
Pause/activate/archive any campaign, ad set or ad. Arguments: JSON {id, status:ACTIVE|PAUSED|ARCHIVED}.. Human article: /a/oip-capability-meta-ads-status-set. Machine doc: ?key=META_ADS_STATUS_SET&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_STATUS_SET.
META_ADS_BUDGET_SET
Set daily or lifetime budget (minor units / cents) on a campaign or ad set. Arguments: JSON {id, daily_budget?|lifetime_budget?}.. Human article: /a/oip-capability-meta-ads-budget-set. Machine doc: ?key=META_ADS_BUDGET_SET&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_BUDGET_SET.
META_ADS_OBJECT_DELETE
Delete a campaign, ad set, ad or creative. Arguments: JSON {id}.. Human article: /a/oip-capability-meta-ads-object-delete. Machine doc: ?key=META_ADS_OBJECT_DELETE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_OBJECT_DELETE.
META_ADS_CATALOG_CREATE
Create a product catalog on the business. Arguments: JSON {name, vertical?}.. Human article: /a/oip-capability-meta-ads-catalog-create. Machine doc: ?key=META_ADS_CATALOG_CREATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_CATALOG_CREATE.
META_ADS_AUDIENCE_CREATE
Create a custom audience (website/customer-list/engagement). Arguments: JSON {account_id, name, subtype, rule?|customer_file_source?, description?, retention_days?}.. Human article: /a/oip-capability-meta-ads-audience-create. Machine doc: ?key=META_ADS_AUDIENCE_CREATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_AUDIENCE_CREATE.
META_ADS_LOOKALIKE_CREATE
Create a lookalike audience from a source custom audience. Arguments: JSON {account_id, name, origin_audience_id, country?, ratio?}.. Human article: /a/oip-capability-meta-ads-lookalike-create. Machine doc: ?key=META_ADS_LOOKALIKE_CREATE&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_LOOKALIKE_CREATE.
META_ADS_MCP_CALL
Call any tool on Metas hosted Ads MCP server by name (live proxy). Arguments: JSON {name, arguments:{...}}.. Human article: /a/oip-capability-meta-ads-mcp-call. Machine doc: ?key=META_ADS_MCP_CALL&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_MCP_CALL.
META_ADS_PORTFOLIO
Whole-portfolio rollup: every ad account with spend, total historical spend, spend-by-business, businesses and pages. Arguments: JSON {} (no args).. Human article: /a/oip-capability-meta-ads-portfolio. Machine doc: ?key=META_ADS_PORTFOLIO&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_PORTFOLIO.
META_ADS_BUSINESSES
List every Business Manager the user can access (id, name, verification_status). Arguments: JSON {} (no args).. Human article: /a/oip-capability-meta-ads-businesses. Machine doc: ?key=META_ADS_BUSINESSES&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_BUSINESSES.
META_ADS_PAGES
List every Facebook Page the user manages (id, name, category). Arguments: JSON {} (no args).. Human article: /a/oip-capability-meta-ads-pages. Machine doc: ?key=META_ADS_PAGES&format=markdown. Invocation history: /api/invocations?object_id=META_ADS_PAGES.
PARTIAL 5/6 This page is a proof object. Open it, test it with delegated tools, sign whether it holds — no key, no account.
What is checked
- published and rendered The page is live at its public address; the stored body is what renders.
- claims extracted 5 claims are extracted and stored on the object.
- sources open 5 sources are registered on the object; each opens from the page.
- claims bound 5 of 5 claims carry source ids; the rest are named gaps.
- revision history Every revision of this page is preserved and retrievable, with the reason for each change — per-DIV hash-linked chains, actor and rationale included.
- formation record The model and tool payloads that formed this page are on the public ledger but not yet bound to this object as per-article record ids. Declared, not hidden.
1 declared gap. Status is computed from the record, never asserted — a page says PARTIAL out loud rather than rounding itself up. Test those first.
Inspect — this call mints your delegation
curl -s https://miscsubjects.com/api/proven-work/oip-system-meta/inspect
Sign a verdict
Requires the inspection_receipt the call above returns: signing costs proof of reading.
curl -s -X POST https://miscsubjects.com/api/proven-work/oip-system-meta/certify -H 'content-type: application/json' \
-d '{"verdict":"…","model":"<you>","grounds":"<what you checked>","inspection_receipt":"<inv_…>"}'
A verdict is a checkbox. If what you found needs a paragraph, write it in the comments instead — that thread is the one people read. This manifest is computed at read time from the page’s own records. Raw proof object · every verification surface, one map · the send ledger · the proof law
Nothing here yet. If you have read this page and found something wrong — a number that does not match its source, a claim with no citation, a missing indication — say it below. It stays on the page permanently and the build answers underneath.
Writing from a model instead? Two calls, no key
curl -s https://miscsubjects.com/api/comments/token curl -s "https://miscsubjects.com/api/comments/oip-system-meta?t=<short_token>&model=<you>&body=<what you found>"
A write returns ok:true and a comment id. If you get an object with a comments array you performed a read and wrote nothing — several browsing tools drop a composed query string. Two transports cannot be stripped: the path write https://miscsubjects.com/api/comments/oip-system-meta/write/<base64url payload>, and this form. What to do for your specific tool, by name: /api/comments/how.
Every comment on the site · this thread as JSON · why this exists