AdsAgent

Refresh one account and its connection Page cache

assets_refresh_ad_account

Create a Facebook authorization link

setup_begin_facebook_connect

Prepare new ads or append to an existing campaign/ad set using request.ad_account_id, a saved template, and one creative_source. Choose append_mode and target IDs explicitly. Use copy_ad_quick_copy for live-ad copies. Review the draft; launch_confirm executes after approval

campaigns_quick_create

Reconcile fixed existing-Ad campaign plans before prepare

campaigns_reconcile_campaign_plan

Prepare recreate from a prior create task

campaigns_recreate_from_task

Check Facebook auth and first sync

setup_check_facebook_connect

Confirm an approved in-place creative swap

ads_replace_creative_confirm

Confirm an approved in-place page swap

ads_replace_page_confirm

Confirm approved copy edits; read back copy on the same Ad ID

ads_update_copy_confirm

Approved QuickCreate/copy/recreate/clone: exact single-use confirm_token; never rewrite or replay. Lost token: operations_get_approval then operations_confirm_approval. Replies: results, not approval handles/JSON/debug.

launch_confirm

Approved status/budget/bid: exact bu_confirm_* or mu_confirm_* from prepare. Single-use; stop at first failed or uncertain item. Replies: results, not approval handles/JSON/debug.

overview_update_confirm

After user approval, pause product-family delivery with exact pd_confirm_* from products_delivery_pause_prepare. Single-use; never replay. Replies: results, not approval handles/JSON/debug.

products_delivery_pause_confirm

Check one existing authorization handle after the user finishes: intent_id accepts ci_*, Meta connect_id or fbconn_live_* handles. Returns status/channel or not_found_or_expired. Reuse the link while valid; do not start automatic polling. For setup connect_id use setup_check_channel_connect

connections_check_intent

Create a single-use browser authorization link for channel=meta|google_ads|tiktok and mode=add_connection; returns connect_url for human authorization. Prefer setup_begin_channel_connect when you need its explicit connect_id/check workflow

connections_create_intent

List redacted platform connections

connections_list

Prepare a same-account 1:1 campaign/ad-set tree clone, keeping each ad's creative. Pass ad_account_id and exactly one source_campaign_id or source_adset_id; copies=1-10. paused is default; inherit may resume spend. Use copy_ad_quick_copy to expand selected ads. Review exclusions, then launch_confirm after approval

copy_ad_clone_structure

Prepare copies of live ads: request_mode=single uses ad_id, source_ad_account_id and target_ad_account_id; grouped uses grouped_plan.campaigns. v3 requires explicit statuses. Choose preserve_post/new_creatives; partnership preserves the post. For a whole tree use copy_ad_clone_structure. Review, then launch_confirm

copy_ad_quick_copy

Get media

creatives_get

Get media batch

creatives_get_batch

List owned creatives; default is the whole library. For upload/how-to help, give [Creative library](https://adsagent.md/dashboard/creatives/browse): choose a folder, Upload images/videos, then search by filename. Use the same AdsAgent account. No list call is needed just for instructions. For reads, trust scope, use limit<=50 and follow next_cursor with unchanged filters

creatives_list

List creative folders

creatives_list_folders

Deny a prepared in-place creative swap

ads_replace_creative_deny

Deny a prepared in-place page swap

ads_replace_page_deny

Discard prepared copy edits without changing the ad

ads_update_copy_deny

Discard a prepared QuickCreate, recreate, ad-copy or structural-clone draft using its exact confirm_token. No Meta write. For a lost token, use operations_get_approval then operations_deny_approval with approval_ref and expected_plan_digest

launch_deny

Discard a prepared status, campaign/ad-set budget or bid update with its exact bu_confirm_* or mu_confirm_* token. No Meta write. Use launch_deny for creation/copy drafts and products_delivery_pause_deny for product-family pauses

overview_update_deny

Discard a product-family pause draft using the exact pd_confirm_* token from products_delivery_pause_prepare. No Meta write. Use overview_update_deny for individual status/budget/bid drafts and launch_deny for creation/copy drafts

products_delivery_pause_deny

Read today's events; channel_pid required

mmp_insights_get_product_event_today

Read today's D0 cohort; channel_pid required

mmp_insights_get_product_today

Read MMP mapping, cohort, and funnel state

mmp_get_state

Export or queue CSV for one bounded scope

insights_export_csv

Read stored Insights date coverage

insights_get_date_range

Queue a fresh Meta breakdown pull for bounded product scopes

insights_pull_product_breakdowns

Cached batch: each needs product_ref/product_name/ad_account_id; group_by, YYYY-MM-DD date_from/date_to; page for all. Partial=unknown, never zero. Use advertised insights_query_consistent

insights_query_batch_overview

Read one scope or a server-side batch. For query_contract_version=1 supply group_by, dates and scope/scopes via request OR direct fields. cached reads stored data; fresh modes may queue refresh tasks. Poll the returned task_ref without duplicate refreshes. Check complete and coverage before using totals; never infer zero from partial data

insights_query_consistent

Read stored aggregated insights for one product/account and YYYY-MM-DD date_from/date_to; group_by=account/campaign/adset/ad. No refresh. Check completeness and paginate while has_more. Use insights_query_batch_overview for many scopes, or insights_query_consistent when the agent-method profile is advertised

insights_query_overview

Read stored product breakdowns

insights_read_breakdowns

Archive one saved audience pack by its exact public name

interests_archive

Preview a reusable audience pack from one live Meta ad set

interests_fetch_from_adset

Read an audience pack by exact name

interests_get