Help / Tools
138 tools
Every operation the assistant can call, grouped by how it affects ad spend. The assistant finds them through meta_ads_read with list_tools; operations marked "via" are called through that tool.
Read and analyze98 tools · Free. Nothing changes.
- Ad account summary
The connected ad account: name, currency, status, lifetime spend.
freeaccount_summaryviameta_ads_read - List Facebook Pages
Facebook Pages that ads can run under.
freelist_pagesviameta_ads_read - List campaigns
Campaigns in the ad account: configured and effective status, objective, budget. Deleted campaigns are not shown, archived only on request.
freelist_campaignsviameta_ads_read - Campaign details
One campaign in full: settings, budget and its ad sets with a targeting summary, optionally its ads.
freecampaign_detailsviameta_ads_read - List ad sets
Ad sets across the whole ad account or one campaign (except deleted and archived by default): configured and effective status, budgets. Join with campaigns on campaign_id.
freelist_adsetsviameta_ads_read - List ads
Ads in the ad account, or in one campaign or ad set: status, effective status, creative.
freelist_adsviameta_ads_read - Ad performance metrics
Metrics for the ad account or an object inside it. Date ranges use the AD ACCOUNT time zone.
freeget_insights - Ad statuses by id
Statuses for a batch of ads in one request, so you do not have to guess what is already off.
freead_statusesviameta_ads_read - List ad images
Images in the ad account library, with the hashes that create_ad_creative takes.
freelist_imagesviameta_ads_read - List ad videos
Videos in the ad account library, with the ids that create_video_creative takes.
freelist_videosviameta_ads_read - List ad creatives
Creatives already built in this ad account: what each one says, where it links and which picture it uses.
freelist_creativesviameta_ads_read - Preview an ad
See the ad as it looks in the feed, drawn by Meta. Answers with a link for a person; no impressions and no spend.
freepreview_adviameta_ads_read - Link to the creatives page
A page where a person adds creatives and sees the ones already in the library. Nothing is sent to Meta by this call.
freeupload_linkviameta_ads_read - List Instagram accounts
Instagram accounts this ad account can run ads from.
freelist_instagram_accountsviameta_ads_read - List custom audiences
Custom and lookalike audiences that Meta lists for this ad account, with size and whether they can be used.
freelist_custom_audiencesviameta_ads_read - Search targeting options
Search Meta targeting options by words: interests, behaviors, demographics, life events, employers, job titles, schools, majors, locations and languages.
freesearch_targetingviameta_ads_read - List pixels
Meta pixels (datasets) this ad account can use, and when each last fired.
freelist_pixelsviameta_ads_read - List custom conversions
Custom conversions of the ad account: event type, pixel and whether they still fire.
freelist_custom_conversionsviameta_ads_read - Pixel event counts
Event counts of one pixel, by event and by hour, for up to the last 168 hours.
freepixel_statsviameta_ads_read - Conversion tracking audit
Check whether the conversion events the active ad sets optimise for are actually arriving.
freeaudit_conversion_tracking - Revenue by campaign
What the ads actually earned: spend from the ad account against the payments the business sent in, per campaign, ad set or ad.
freerevenue_report - Wasted spend analysis
Classify the campaigns that spent in a window: wasted, below target, lead campaigns, learning or too little data.
freeanalyze_wasted_spendviameta_ads_read - Audience breakdown
Which age and gender groups the money goes to, what each of them brings, and where a result costs more than it does across the ad account.
freeanalyze_audiencesviameta_ads_read - Placement breakdown
Which placements the money goes to — Feed, Stories, Reels, Audience Network and the rest — what each brings and where a result costs more than across the ad account.
freeanalyze_placementsviameta_ads_read - Creative fatigue
Score the active ads for creative fatigue: frequency, link CTR decline and how long they have been running.
freedetect_creative_fatigueviameta_ads_read - Explain a metric change
Explain a change in one metric against the 30, 60 and 90 day baselines, with the factors behind it.
freeexplain_anomalyviameta_ads_read - Budget split recommendation
Recommend how to split a monthly budget pool across campaigns or ad sets. It changes nothing.
freeoptimize_budgetviameta_ads_read - Funnel diagnosis
Walk the funnel in order — tracking, revenue, traffic, conversion, spend — and stop at the first broken step.
freediagnose_funnelviameta_ads_read - Browse targeting options
Browse a whole Meta targeting category: interests, behaviors, demographics, life events, industries, income or family statuses.
freebrowse_targetingviameta_ads_read - Pick a campaign type
The order of tools that builds a campaign of a given type, and what it needs before it can be built.
freeselect_campaign_typeviameta_ads_read - Status of a campaign copy
Check an asynchronous campaign copy: whether Meta finished it and what it produced.
freecopy_statusviameta_ads_read - App promotion performance
App promotion campaigns of this ad account: spend, installs and cost per install by campaign, ad set or ad, with the in-app events Meta reports for them.
freeapp_performanceviameta_ads_read - List promotable apps
Mobile apps this ad account may advertise, with their store links and the events they report.
freelist_promotable_appsviameta_ads_read - List monitors
Monitors of this ad account: their conditions, status, last check and how often they triggered.
freelist_monitorsviameta_ads_read - Get monitor history
When a monitor triggered, on which campaigns, ad sets or ads, with what numbers, and whether an email went out.
freeget_monitor_historyviameta_ads_read - Test a monitor
Dry-run a monitor now: which campaigns, ad sets or ads would trigger and which are skipped, without recording or emailing.
freetest_monitorviameta_ads_read - List scheduled tasks
Scheduled briefs of this account and monitors of this ad account, with status, schedule and last run.
freelist_scheduled_tasksviameta_ads_read - List watchdog signals
What the watchdog found in this ad account and has not seen resolved.
freelist_signalsviameta_ads_read - Run the watchdog now
Run the watchdog over this ad account right now instead of waiting for its next pass.
freerun_watch_nowviameta_ads_read - List prepared actions
Changes the watchdog and monitors prepared for approval: pauses and budget changes, with what each would do.
freelist_pending_actionsviameta_ads_read - Get a signal briefing
One finding of the watchdog or a monitor: what was seen, since when, and the changes prepared for it.
freeget_signal_briefingviameta_ads_read - Google Ads account summary
The connected Google Ads account: name, currency, time zone, status, test or production, manager or client.
freegoogle_account_summaryviagoogle_ads_read - List Google Ads campaigns
Campaigns in the Google Ads account: status, why they do or do not serve, type, bidding, budget and dates. Removed campaigns only on request.
freegoogle_list_campaignsviagoogle_ads_read - List Google Ads ad groups
Ad groups of one Google Ads campaign: status, type and the default CPC bid.
freegoogle_list_ad_groupsviagoogle_ads_read - Google Ads performance
Google Ads metrics for the account, its campaigns, ad groups or keywords over a period: cost, impressions, clicks, CTR, CPC, conversions, value, CPA, ROAS.
freegoogle_campaign_performance - Google Ads ad performance
Google Ads metrics per ad over a period: cost, clicks, CTR, CPC, conversions, CPA, ROAS, with ad strength and serving status.
freegoogle_ad_performanceviagoogle_ads_read - Google Ads search terms
What people actually searched for when your Search ads showed, with the keyword that matched and the metrics of each search term.
freegoogle_search_termsviagoogle_ads_read - Google Ads placements
Where Display, Video, Demand Gen and Performance Max ads were shown — websites, apps, YouTube channels and videos — with metrics.
freegoogle_placement_performanceviagoogle_ads_read - Google Ads reach and frequency
How many unique people Display, Video and Demand Gen campaigns reached and how often each saw the ads, over a period.
freegoogle_reach_frequencyviagoogle_ads_read - Google Ads conversions by action
Conversions and their value per conversion action over a period, for the account or split by campaign.
freegoogle_conversion_performanceviagoogle_ads_read - Google Ads recommendations
Recommendations Google Ads itself offers for the account, grouped by type, with Google's own estimate of what applying them would change, plus the budget options and keyword ideas behind them. Read only: this server never applies a recommendation.
freegoogle_recommendationsviagoogle_ads_read - Google Ads landing pages
Landing pages of Google Ads over a period: spend, clicks, conversions and value per page, with the mobile loading speed score Google gives the page, and findings about pages that take money without converting.
freegoogle_landing_pagesviagoogle_ads_read - Google Ads campaign structure
What a Google Ads campaign is made of: its ad groups with bids, and on request their keywords, negative keywords and ads.
freegoogle_campaign_structureviagoogle_ads_read - Google Ads campaign settings
All settings of one Google Ads campaign: dates, bidding and targets, budget, networks, location options, tracking template and URL parameters, frequency caps, Shopping feed and AI Max.
freegoogle_campaign_settingsviagoogle_ads_read - Google Ads ad group settings
Settings of one Google Ads ad group: status, type, bids and targets, ad rotation, targeting or observation per audience dimension, tracking, device bid adjustments and Demand Gen channels.
freegoogle_ad_group_settingsviagoogle_ads_read - Google Ads ads and texts
Ads with their texts: headlines, descriptions, paths and final URLs of responsive search, display and Demand Gen ads.
freegoogle_adsviagoogle_ads_read - Google Ads policy issues
Ads that Google disapproved or limited, with the policy topics and the evidence Google gives.
freegoogle_ad_policy_issuesviagoogle_ads_read - Google Ads labels
Labels of the Google Ads account, or the labels on one campaign.
freegoogle_labelsviagoogle_ads_read - Google Ads change history
Who changed what in the Google Ads account and when: campaigns, budgets, ad groups, ads, keywords, targeting and assets.
freegoogle_change_historyviagoogle_ads_read - Google Ads campaign targeting
Who and where a Google Ads campaign targets: locations and radius, languages, ad schedule, devices, audiences, demographics and exclusions.
freegoogle_campaign_targetingviagoogle_ads_read - Google Ads ad group targeting
Targeting inside ad groups: keywords, placements, YouTube channels and videos, apps, topics, audiences and demographics — for Search, Display and Demand Gen.
freegoogle_ad_group_criteriaviagoogle_ads_read - Search Google Ads audiences
Find audiences by name: Google interest and in-market categories, the account custom audiences, remarketing lists and audiences.
freegoogle_search_audiencesviagoogle_ads_read - Find Google Ads locations
Find Google location ids by name — countries, regions, cities, postal codes — with their full names and parents.
freegoogle_locationsviagoogle_ads_read - Google Ads languages
Languages Google Ads can target, with their ids and codes; search narrows by name or code.
freegoogle_languagesviagoogle_ads_read - Google Ads campaign assets
Assets (extensions) a campaign uses — sitelinks, callouts, structured snippets, calls, images, texts — at campaign, account and ad group level.
freegoogle_campaign_assetsviagoogle_ads_read - Google Ads asset library
Assets already in the account library — images, YouTube videos, texts, sitelinks, callouts and more — to reuse in campaigns.
freegoogle_asset_libraryviagoogle_ads_read - Performance Max asset groups
Asset groups of a Performance Max campaign: status, why they serve or not, ad strength, final URLs and metrics over a period.
freegoogle_pmax_asset_groupsviagoogle_ads_read - Performance Max assets
Texts, images, logos and videos in Performance Max asset groups, with whether each serves and why not.
freegoogle_pmax_assetsviagoogle_ads_read - Performance Max signals
Search themes and audience signals of Performance Max asset groups — the hints that steer who Performance Max looks for.
freegoogle_pmax_signalsviagoogle_ads_read - Google Ads campaign conversion goals
Which conversion goals a campaign bids for: each goal category and source, and whether it is biddable.
freegoogle_conversion_goalsviagoogle_ads_read - Google Ads Shopping product groups
The product group tree of a Shopping ad group: how products are split by brand, category, type, item id or custom label, with bids.
freegoogle_product_groupsviagoogle_ads_read - Performance Max listing filters
Which products or pages a Performance Max asset group advertises: its listing group filter tree.
freegoogle_listing_filtersviagoogle_ads_read - Google Ads Merchant Center links
Merchant Center accounts linked to this Google Ads account — the product feeds Shopping and Performance Max can use.
freegoogle_merchant_center_linksviagoogle_ads_read - Google Ads conversion actions
Conversion actions of the account: what counts as a conversion, primary or secondary, value, counting, attribution and windows.
freegoogle_conversion_actionsviagoogle_ads_read - Google Ads wasted spend
Where Google Ads money brings nothing back: campaigns with no conversions or with a cost per conversion far above target, and the costliest search terms that never converted.
freegoogle_wasted_spendviagoogle_ads_read - Google Ads budget allocation plan
A plan to move daily budget between Google Ads campaigns toward those that bring conversions (or value) cheaper, within limits. Nothing is changed.
freegoogle_budget_allocationviagoogle_ads_read - Explain a Google Ads change
Why a Google Ads metric changed between two periods: which campaigns moved it, and which edits in the account (budgets, statuses, bids, targeting, ads) happened around that time.
freegoogle_explain_changeviagoogle_ads_read - Google Ads ad copy brief
Everything needed to write new Google ad texts for a campaign: current headlines and descriptions with Google ratings, converting keywords and search terms, landing pages and character limits. The assistant writes the texts.
freegoogle_ad_copy_briefviagoogle_ads_read - Google Ads search term insights
What to do with search terms: converting terms that are not keywords yet, costly terms that never converted (negative keyword candidates), and how each match type performs.
freegoogle_search_term_insightsviagoogle_ads_read - Audit Google Ads conversion tracking
Audit how this Google Ads account tracks conversions: a 0–100 score and A–F grade with the findings behind it.
freegoogle_audit_conversion_trackingviagoogle_ads_read - Diagnose the Google Ads funnel
Walk the Google Ads funnel step by step — tracking, value, traffic, conversion, landing pages, spend — and stop at the first broken step.
freegoogle_diagnose_funnelviagoogle_ads_read - List Google Ads watchdog signals
What the watchdog found in this Google Ads account and has not seen resolved.
freegoogle_list_signalsviagoogle_ads_read - Run the Google Ads watchdog now
Run the watchdog over this Google Ads account right now instead of waiting for its next pass.
freegoogle_run_watch_nowviagoogle_ads_read - Get a Google Ads signal briefing
One finding of the watchdog or a monitor on this Google Ads account, with the live context to judge it: status, daily numbers, recent changes.
freegoogle_get_signal_briefingviagoogle_ads_read - List Google Ads monitors
Monitors of this Google Ads account: their conditions, status, last check and how often they triggered.
freegoogle_list_monitorsviagoogle_ads_read - Get Google Ads monitor history
When a Google Ads monitor triggered, on which campaigns or ad groups, with what numbers, and whether an email went out.
freegoogle_get_monitor_historyviagoogle_ads_read - Test a Google Ads monitor
Dry-run a Google Ads monitor now: which campaigns or ad groups would trigger and which are skipped, without recording or emailing.
freegoogle_test_monitorviagoogle_ads_read - GA4 report
A Google Analytics (GA4) report of the connected property: chosen dimensions and metrics over a period, with totals and an optional comparison with the period before.
freega4_reportviagoogle_analytics_read - GA4 attribution check
Checks where GA4 loses the source of traffic and key events: sessions with no channel, sessions without a source, key events piling up in Direct, your own domains and payment services as referrals, and Facebook or Instagram clicks without UTM tags.
freega4_attribution_checkviagoogle_analytics_read - GA4 landing pages
Landing pages of the connected GA4 property: sessions, engagement and key events per page against the average, for all traffic or one channel or source / medium — which pages lose the traffic you pay for and which convert best.
freega4_landing_pagesviagoogle_analytics_read - GA4 and Google Ads comparison
Compares Google Ads with GA4 campaign by campaign: paid clicks against GA4 sessions from google / cpc, and Google Ads conversions against GA4 key events — where the tracking between them loses traffic or conversions.
freega4_google_ads_checkviagoogle_analytics_read - GA4 and Meta ads comparison
Compares Meta ads with GA4 campaign by campaign: link clicks and landing page views against GA4 sessions from Meta, and Meta results against GA4 key events — where UTM tags, visits or leads get lost between Meta and the site.
freega4_meta_ads_checkviagoogle_analytics_read - List site watchdog signals
What the watchdog found about this site and has not seen fixed: a missing Meta pixel, a key event that never fires, lost attribution.
freega4_list_signalsviagoogle_analytics_read - GA4 property setup
The setup of the connected GA4 property: time zone and currency, data streams, key events and how many of each were recorded in the last 30 days, links to Google Ads accounts and how long event data is kept — with what to fix.
freega4_property_setupviagoogle_analytics_read - Search Console performance
Google Search performance of the connected Search Console site: clicks, impressions, CTR and average position by query, page, country, device, date or search appearance, with the site totals for the period.
freesearch_console_performanceviasearch_console_read - Paid and organic search
Compares Google Search results of the connected site with the search terms of a connected Google Ads account: terms Google Ads pays for where the site already ranks in the top 3, searches on page 2 and lower with no ads, and terms that convert in Google Ads where the site is not visible organically.
freesearch_console_paid_organicviasearch_console_read - Search Console indexing
Indexing state of pages as Google sees them: whether the page is indexed, which address Google picked as canonical, whether robots.txt or a noindex tag blocks it, when Google last crawled it and whether the fetch succeeded.
freesearch_console_indexingviasearch_console_read - Search Console opportunities
Where Google Search is close to paying off: pages or queries sitting just off the first page, ones shown often but rarely clicked, and ones that lost position against the previous period.
freesearch_console_opportunitiesviasearch_console_read
Pause spend3 tools · Free, applied from chat, available even when a payment is overdue.
- Pause an ad
Pause one ad, or up to ten at once. To turn them back on: launch_ad (approved by a signed-in person) or Ads Manager.
freepause_adviameta_ads_update - Pause an entire campaign
Pause a whole campaign, together with all of its ad sets and ads.
freepause_campaignviameta_ads_update - Pause an ad set
Pause delivery of an ad set, or up to ten at once. Spend stops.
freepause_adsetviameta_ads_update
Lower or end spend5 tools · Applied from chat after a preview.
- Lower a budget
Lower a budget, or cap what an ad set may take from a campaign budget. It can only go down.
counts toward the change limitlower_budgetviameta_ads_update - Archive or delete an object
Archive or delete a campaign, an ad set or an ad. It stops delivery for good: Meta cannot bring an archived or deleted object back.
counts toward the change limitarchive_objectviameta_ads_delete - Shorten a schedule
Bring the end of a schedule forward, or push a start that has not arrived yet later. It can only shorten.
counts toward the change limitshorten_scheduleviameta_ads_update - Approve or reject a prepared action
Approve or reject one prepared action. Approving runs its change the usual way; an increase in spend needs a signed-in person.
freemanage_actionviameta_ads_update - Apply prepared actions of a finding
Apply every prepared action of one finding that can be applied from chat.
freeapply_signal_actionsviameta_ads_update
Prepare without affecting spend22 tools · Applied from chat after a preview.
- Create an image ad creative
Create a single-image creative. No impressions and no spend.
counts toward the change limitcreate_ad_creativeviameta_ads_create - Create a video ad creative
Create a creative from a video that is already in the ad account library. No impressions and no spend.
counts toward the change limitcreate_video_creativeviameta_ads_create - Create a carousel ad creative
Create a carousel creative of 2 to 10 cards. No impressions and no spend.
counts toward the change limitcreate_carousel_creativeviameta_ads_create - Create a paused ad
Create an ad in an ad set. Always PAUSED: turning it on is a separate action by a person.
counts toward the change limitcreate_adviameta_ads_create - Upload image to ad library
Upload one image, or a batch of up to ten, from https links into the ad account library. No impressions and no spend.
counts toward the change limitupload_imageviameta_ads_create - Upload video to ad library
Upload a video from an https link to the ad account library. No impressions and no spend.
counts toward the change limitupload_videoviameta_ads_create - Rename an object
Rename a campaign, ad set, ad or creative. Only the name changes.
counts toward the change limitrename_objectviameta_ads_update - Duplicate an ad set without ads
Copy an audience into a new ad set, WITHOUT ads, for a new creative. The copy is paused.
counts toward the change limitduplicate_adsetviameta_ads_create - Create a paused campaign
Create a complete campaign: creative → campaign → ad set → ad. Everything is paused.
counts toward the change limitcreate_campaignviameta_ads_create - Create a paused ad set
Create a paused ad set in an existing campaign, with its budget, schedule and audience.
counts toward the change limitcreate_adsetviameta_ads_create - Create a Dynamic Creative ad
Create one paused Dynamic Creative ad: Meta combines the images and texts itself.
counts toward the change limitcreate_dynamic_creative_adviameta_ads_create - Swap the creative of a paused ad
Replace the creative on an ad that cannot deliver right now. Nothing is turned on and spend does not change.
counts toward the change limitswap_ad_creativeviameta_ads_update - Narrow an audience
Narrow an ad set's audience: fewer locations, a tighter age range, more exclusions, fewer placements. It cannot widen anything.
counts toward the change limitnarrow_adset_targetingviameta_ads_update - Create a monitor
Watch every campaign, ad set or ad of this ad account and email when a rule holds on one of them.
freecreate_monitorviameta_ads_create - Delete a monitor
Delete a monitor: it stops being checked and stops sending email.
freedelete_monitorviameta_ads_delete - Pause or resume a scheduled task
Pause or resume a monitor or a scheduled brief.
freemanage_scheduled_taskviameta_ads_update - Schedule a brief
Email a performance brief of every connected ad account on a schedule: daily, weekly on Mondays, or every N days.
freeschedule_briefviameta_ads_create - Send a brief now
Send a scheduled brief right now, without waiting for its schedule; the next scheduled send stays as it is.
freesend_brief_nowviameta_ads_create - Delete a scheduled task
Delete a scheduled brief or a monitor: it stops for good.
freedelete_scheduled_taskviameta_ads_delete - Create a Google Ads monitor
Watch every campaign or ad group of this Google Ads account and email when a rule holds on one of them.
freegoogle_create_monitorviagoogle_ads_create - Pause or resume a Google Ads monitor
Pause or resume a Google Ads monitor.
freegoogle_manage_monitorviagoogle_ads_update - Delete a Google Ads monitor
Delete a Google Ads monitor: it stops being checked and stops sending email.
freegoogle_delete_monitorviagoogle_ads_delete
Can increase spend10 tools · Approved by a signed-in person.
- Turn on an ad set (human approval)
Turn on delivery for an ad set: the campaign, the ad set, and its ads switch to ACTIVE.
a signed-in person approvescounts toward the change limitlaunch_adsetviameta_ads_update - Turn on an ad (human approval)
Turn on a single ad. If its ad set and campaign are on, it starts spending immediately.
a signed-in person approvescounts toward the change limitlaunch_adviameta_ads_update - Change a budget (human approval)
Raise or change a budget on an ad set or a campaign. The amount is in regular currency units.
a signed-in person approvescounts toward the change limitupdate_budgetviameta_ads_update - Swap the creative of a live ad (human approval)
Replace the creative on an ad that can deliver. The ad goes back to Meta review and may restart learning.
a signed-in person approvescounts toward the change limitswap_live_ad_creativeviameta_ads_update - Change an audience (human approval)
Change an ad set's audience: locations, age, gender, detailed targeting, custom audiences, placements.
a signed-in person approvescounts toward the change limitupdate_adset_targetingviameta_ads_update - Change ad tracking parameters
Change the URL parameters on an ad, or on every ad in an ad set, or opt an ad out of multi-advertiser ads.
a signed-in person approves if it can increase spendcounts toward the change limitupdate_ad_trackingviameta_ads_update - Turn on a campaign (human approval)
Turn on a campaign. Every ad set in it with its own ACTIVE status starts spending.
a signed-in person approvescounts toward the change limitlaunch_campaignviameta_ads_update - Duplicate a campaign
Copy a whole campaign with its ad sets and ads. The copy is paused unless ACTIVE is asked for.
a signed-in person approves if it can increase spendcounts toward the change limitduplicate_campaignviameta_ads_create - Change a schedule (human approval)
Change when an ad set or a campaign starts and stops delivering.
a signed-in person approvescounts toward the change limitupdate_scheduleviameta_ads_update - Change a bid (human approval)
Change how Meta bids for an ad set, or the bid strategy of a campaign.
a signed-in person approvescounts toward the change limitupdate_bidviameta_ads_update