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: 54. Machine system map: /api/dispatch?map=META&format=markdown. Root: /a/oip.
Operations
META
Read the Meta Marketing API through one door — ad accounts, campaigns, ad sets, ads, creatives, images and insights — instead of fifty separate META_ADS_* rows. Use when: Any read of Meta advertising state. Arguments: op (required) — Which read to perform · node (optional) — The Graph node the op reads · level (optional) — insights only: the row grain to report at · since (optional) — insights only: first day of the reporting window, YYYY-MM-DD · until (optional) — insights only: last day of the reporting window, YYYY-MM-DD. Human article: /a/oip-capability-meta. Machine doc: ?key=META&format=markdown. Invocation history: /api/invocations?object_id=META.
META_CAPI_EVENT
Hash the PII fields then POST to Meta CAPI. $1=em, $2=ph, $3=eid, $4=event_name, $5=event_id, $6=source_url, $7=fbp, $8=fbc. Use when: When you need to hash the PII fields then POST to Meta CAPI. 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.
META_AD_LIBRARY_SEARCH
Search Meta's public Ad Library (Graph ads_archive — same call as Graph API Explorer). Uses the live loop-meta-bridge token, not the expired Pages META_ACCESS_TOKEN. Use when: competitor ads, what is running for a term or page. Arguments: $1 = search_terms (or JSON {search_terms, ad_reached_countries?, search_page_ids?, limit?}). Human article: /a/oip-capability-meta-ad-library-search. Machine doc: ?key=META_AD_LIBRARY_SEARCH&format=markdown. Invocation history: /api/invocations?object_id=META_AD_LIBRARY_SEARCH.
META_CAPI_POST
Post one server-side conversion event to Meta's Conversions API, so a conversion that happened off the browser still reaches the ad account's optimisation and reporting. Split out of the META row on 2026-09-13: META is a read door with ten read operations whose arguments line up, and capi_post is a write with six completely different arguments, so it could not be described in the same argument list without making both of them ambiguous. Use when: Recording a conversion the pixel could not see — a server-side purchase, a lead captured off-site, an offline event. Arguments: event_name (required) — The standard Meta event name, e · event_time (required) — When the conversion happened, as a Unix timestamp in whole seconds · event_id (required) — A stable id for this conversion, used to deduplicate against the browser pixel · event_source_url (required) — The full URL where the conversion happened · client_ip_address (optional) — The end user's IP address, for attribution matching · client_user_agent (optional) — The end user's browser user-agent string, for attribution matching. Human article: /a/oip-capability-meta-capi-post. Machine doc: ?key=META_CAPI_POST&format=markdown. Invocation history: /api/invocations?object_id=META_CAPI_POST.
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