Documentation / Tool Reference

Meta Ads tools

Tools for Facebook & Instagram ads: campaign/ad set/ad management, all ad formats, custom & lookalike audiences, detailed targeting, and insights.

Connection & Account · 3

connect_meta_adsfree

Generates a one-time authorization link to connect a Meta (Facebook/Instagram) ad account.

list_meta_ad_accounts1 credits

Lists the user's connected Meta ad account(s).

all_accessible
list_meta_pages1 credits

Lists the Facebook Pages managed by the connected Meta user (id, name, category).

account_id

Reading & Reporting · 9

list_meta_ads1 credits

Lists Meta ads; if adset_id is provided, limits to that ad set.

account_idadset_id
list_meta_adsets1 credits

Lists Meta ad sets; if campaign_id is provided, limits to that campaign.

account_idcampaign_id
list_meta_audiences1 credits

Lists the custom audiences (custom/lookalike/website retargeting) in the Meta ad account.

account_id
list_meta_campaigns1 credits

Lists the campaigns in a Meta ad account.

account_id
list_meta_page_posts1 credits

Lists a Facebook Page's recent posts and THEIR MEDIA, so content already published on the Page can be reused as ad creative.

page_idlimit
list_meta_pixels1 credits

Lists the conversion pixels in a Meta ad account (id, name, last fired).

account_id
meta_campaign_insights2 credits

Meta performance report (impressions/clicks/spend/reach/conversion actions).

account_iddate_presetlevelbreakdownsinceuntil
meta_reach_estimate2 credits

Returns the estimated reach for a targeting setup (audience size before spending).

account_idcountriesage_minage_maxinterest_idsgendersrelationship_statuseseducation_statusesfamily_statuseslife_eventsindustriesbehaviorsoptimization_goal
search_meta_interests1 credits

Searches Meta detailed-targeting entities by name → returns id + estimated audience size.

querykindlimitcategory_class

Campaign · 3

create_meta_campaign8 credits

Creates a Meta campaign.

account_idnameobjectivedaily_budgetspecial_ad_categoriesstatusconfirm
delete_meta_campaign5 credits

Deletes a Meta campaign (reporting data remains readable in Meta).

account_idcampaign_idconfirm
update_meta_campaign5 credits

Updates a Meta campaign (only the provided fields).

account_idcampaign_idnamestatusdaily_budgetconfirm

Ad set · 3

create_meta_adset5 credits

Creates a Meta ad set.

account_idcampaign_idnameoptimization_goalbilling_eventdaily_budgetcountriesregionscitiesage_minage_maxgendersinterest_idsrelationship_statuses
delete_meta_adset5 credits

Deletes a Meta ad set.

account_idadset_idconfirm
update_meta_adset5 credits

Updates a Meta ad set (only the fields provided).

account_idadset_idnamestatusdaily_budgetpublisher_platformsfacebook_positionsinstagram_positionswhatsapp_positionsmessenger_positionsaudience_network_positionsthreads_positionsaudience_expansionage_min

Ad & Creative · 10

copy_meta_entity5 credits

Copies a Meta campaign/ad set/ad (the 'Duplicate' action in Ads Manager).

account_idkindentity_iddeep_copyrename_prefixconfirm
create_meta_carousel_ad8 credits

Creates a Meta carousel ad (2-10 cards).

account_idadset_idnamepage_idmessagecardscta_typewelcome_messagegreetingice_breakersstatusconfirm
create_meta_instagram_post_ad8 credits

Turns an EXISTING Instagram post/Reel into an ad (Ads Manager's "Use existing post → Instagram").

account_idadset_idnameig_media_idpage_idig_user_idwelcome_messagegreetingice_breakerscta_typelinkstatusconfirm
create_meta_link_ad8 credits

Creates a Meta link ad (creative + ad in one step).

account_idadset_idnamepage_idmessagelinkheadlineimage_urlimage_base64image_hashcta_typestatuswelcome_messagegreeting
create_meta_post_ad8 credits

Turns an existing Facebook/Instagram Page post into an ad (boosts an organic post).

account_idadset_idnameobject_story_idstatuscta_typelinkconfirm
create_meta_video_ad8 credits

Creates a Meta video ad.

account_idadset_idnamepage_idvideo_urlvideo_idmessagelinkheadlineimage_urlimage_base64image_hashcta_typewelcome_message
delete_meta_ad5 credits

Deletes a Meta ad.

account_idad_idconfirm
update_meta_ad5 credits

Changes a Meta ad's name/status.

account_idad_idnamestatusconfirm
update_meta_ad_creativefree

Replaces an existing ad's CREATIVE (image, text, destination link, and call-to-action button) WITHOUT deleting the ad — a new creative is built and swapped in, so the ad keeps its ID, learning phase and history (no delete-and-recreate).

account_idad_idpage_idmessagelinkheadlineimage_urlimage_base64image_hashcta_typenamewelcome_messagegreetingice_breakers
update_meta_instagram_post_ad8 credits

Adds or changes the pre-filled WhatsApp/Messenger message (and optionally the button) on an EXISTING Instagram-post ad WITHOUT unlinking it from the organic post.

account_idad_idwelcome_messagegreetingice_breakerscta_typelinkconfirm

Audiences · 2

create_meta_lookalike_audience5 credits

Creates a lookalike audience from a source custom audience.

account_idnamesource_audience_idcountryratioconfirm
create_meta_website_audience5 credits

Creates a website retargeting audience from a pixel.

account_idnamepixel_idretention_dayseventconfirm

Other

create_meta_ab_testfree

Creates a Meta SPLIT TEST (A/B) that compares two existing campaigns 50/50 on non-overlapping audiences and reports a statistically fair winner.

account_idnamecampaign_acampaign_bstart_timeend_timecontrol_nametreatment_nameconfirm
create_meta_custom_conversionfree

Creates a custom conversion on a pixel.

account_idnamepixel_idurl_containseventcustom_event_typeconfirm
create_meta_dynamic_ad8 credits

Creates a dynamic product ad (DPA) — one creative that automatically pulls products from the catalog.

account_idadset_idnamepage_idproduct_set_idmessagedescriptioncall_to_actionfallback_linkstatusconfirm
create_meta_engagement_audiencefree

Builds a Meta retargeting audience from ENGAGEMENT instead of website traffic — people who watched your video, interacted with your Facebook Page or Instagram profile, or opened your lead form.

account_idnamesourcesource_ideventretention_daysconfirm
create_meta_lead_formfree

Creates an INSTANT FORM (lead form) on a Facebook Page, with custom questions, and returns the form id to attach to a lead ad.

page_idnamequestionsprivacy_policy_urlfollow_up_urlintro_headlineintro_descriptionthank_you_textlocaleconfirm
delete_meta_audiencefree

DELETES a Meta custom/lookalike audience — the cleanup for lists built by mistake, duplicates, or audiences you must remove on a privacy request.

audience_idconfirm
download_meta_leads1 credits

Downloads the answers people submitted through a Meta instant form — name, phone, email and every custom question, with the ad, ad set and campaign each lead came from.

form_idlimitsince
find_instagram_media_id1 credits

Turns an Instagram POST or REEL LINK into the media id needed to advertise it, so nobody has to dig the id out by hand.

urlaccount_idig_user_id
get_meta_ad_creativefree

Reads an EXISTING Meta ad's creative: headline, primary text, description, image or video, the button, the destination link, the Page and Instagram actor, and WHICH Advantage+ creative enhancements are currently switched on.

ad_id
instagram_follower_growthfree

Reports how many Instagram FOLLOWERS an account gained per day, so follower/profile-visit campaigns can finally be measured.

daysig_user_idcapture_now
list_meta_catalogs1 credits

Lists the product catalogs on the ad account's Business Manager — the source for catalog / dynamic product ads (DPA), the highest-ROAS format for e-commerce.

account_id
list_meta_custom_conversionsfree

Lists the account's custom conversions (URL- or event-based conversion definitions built on a pixel, e.g.

account_idinclude_archived
list_meta_instagram_accounts1 credits

Lists the Instagram accounts usable from a Meta ad account.

account_id
list_meta_instagram_posts1 credits

Lists the posts and Reels published on an Instagram Business account — Instagram-native content (including Reels not shared to Facebook) that list_meta_page_posts CANNOT see.

page_idlimitig_user_idaccount_id
list_meta_lead_formsfree

Lists the INSTANT FORMS (lead forms) that belong to a Facebook Page — id, name, status and the questions each one asks.

page_idlimit
list_meta_product_sets1 credits

Lists the product sets inside a Meta product catalog.

catalog_id
list_meta_saved_audiencesfree

Lists the account's SAVED audiences (reusable targeting presets — interests + geo + demographics saved in Ads Manager) with approximate size.

account_id
meta_change_history2 credits

Meta ACTIVITY / CHANGE HISTORY (audit trail) — WHO changed WHAT and WHEN in a Meta ad account, the equivalent of Ads Manager's "Activity history" and of get_change_history on Google Ads.

account_idsinceuntillevellimit
meta_delivery_estimatefree

Estimates an ad set's reachable audience size and expected daily results for its CURRENT targeting/optimization — WITHOUT spending.

adset_idoptimization_goal
preview_meta_adfree

Renders a visual PREVIEW of an ad creative WITHOUT publishing it — returns a preview URL you can open in a browser to see exactly how the ad will look in a given placement (great for reviewing before launch).

creative_idad_format
send_meta_conversion_eventfree

SENDS A SERVER-SIDE CONVERSION EVENT to Meta (Conversions API) — the fix for conversions lost to iOS 14+ / ad-blockers / cookie limits, and the only way to report sales that happen off the website (CRM, phone, showroom, POS).

account_idpixel_idevent_nameemailphoneexternal_idvaluecurrencyevent_idevent_source_urlaction_sourcefbcfbptest_event_code
update_meta_custom_conversionfree

Renames a custom conversion, or sets its description / default conversion value.

conversion_idnamedescriptiondefault_conversion_valueconfirm
upload_meta_image1 credits

Uploads an image creative to Meta and returns its image_hash — reusable across ads.

account_idimage_urlimage_base64object_story_id
upload_meta_video3 credits

Gets a video into the user's Meta ad account and returns its video_id, WITHOUT leaving the chat.

account_idvideo_urlticket