Meta tools
Facebook and Instagram campaigns, ad sets, audiences, creatives, lead form results and reach estimates.
Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind der englische Originaltext, den der Assistent sieht.
Lese-Tools10 Tools
list_meta_ad_accounts
Lesen1 CreditsMeta ad accounts reachable with the connected Meta token: id (act_…), name, currency, status, timezone, lifetime spend, business, and which one is selected. Read only; connected=false when Meta is not linked.
Dieses Tool hat keine Parameter.
meta_insights_report
Lesen2 CreditsFacebook + Instagram performance (Meta Insights) at campaign, ad set or ad level for a date range, optionally broken down by age, gender, placement or device: spend, impressions, reach, frequency, clicks, CTR, CPM, CPC, conversions, revenue, ROAS (purchase_roas) and CPA (cost_per_action_type). Sort by any metric and filter with thresholds (e.g. roas_below=3 sorted by spend, cpa_above=40). Real data only.
| Parameter | Typ | Beschreibung |
|---|---|---|
levelOptional | campaign | adset | ad | — |
daysOptional | integer (1–1125) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
breakdownOptional | none | age | gender | age_gender | publisher_platform | placement | placement_device | device | device_platform | country | region | placement = publisher_platform + platform_position; device = impression_device |
conversion_eventOptional | purchase | lead | add_to_cart | complete_registration | messaging | link_click | result type used for conversions and CPA (default purchase) |
campaign_idsOptional | array<string> | — |
adset_idsOptional | array<string> | — |
ad_idsOptional | array<string> | — |
sort_byOptional | spend | roas | cpa | conversions | revenue | frequency | reach | impressions | clicks | ctr | cpm | cpc | — |
sort_orderOptional | desc | asc | — |
min_spendOptional | number | — |
roas_belowOptional | number | — |
roas_aboveOptional | number | — |
cpa_aboveOptional | number | — |
cpa_belowOptional | number | — |
frequency_aboveOptional | number | — |
limitOptional | integer (1–500) | — |
meta_top_creatives
Lesen2 CreditsBest-performing Meta ads (creatives) in a placement such as Instagram Reels, ranked by ROAS, CPA, conversions or CTR, with creative details (thumbnail, video, Instagram permalink) and their ad set ids for duplication.
| Parameter | Typ | Beschreibung |
|---|---|---|
placementOptional | string | all | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (matched against publisher_platform:platform_position) |
metricOptional | roas | cpa | conversions | ctr | spend | revenue | — |
conversion_eventOptional | purchase | lead | add_to_cart | complete_registration | messaging | link_click | result type used for conversions and CPA (default purchase) |
daysOptional | integer (1–1125) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
limitOptional | integer (1–25) | — |
min_spendOptional | number | — |
campaign_idsOptional | array<string> | — |
list_meta_audiences
Lesen1 CreditsCustom and lookalike audiences of the Meta ad account: id, name, subtype, approximate size range, retention, delivery status.
Dieses Tool hat keine Parameter.
search_meta_interests
Lesen1 CreditsSearch Meta's interest taxonomy (targeting search) by keyword: interest id, name, path and audience size range. Use the ids in targeting.interest_ids.
| Parameter | Typ | Beschreibung |
|---|---|---|
queryPflicht | string | — |
limitOptional | integer (1–100) | — |
localeOptional | string | e.g. tr_TR, en_US |
meta_reach_estimate
Lesen2 CreditsEstimated audience size for a targeting set before spending (Meta delivery estimate, falling back to reach estimate): monthly active users range and daily users.
| Parameter | Typ | Beschreibung |
|---|---|---|
targetingPflicht | object | — |
optimization_goalOptional | string | REACH (default), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS … |
pixel_idOptional | string | — |
custom_event_typeOptional | string | e.g. PURCHASE (with pixel_id) |
list_meta_ad_sets
Lesen1 CreditsMeta ad sets with status, daily/lifetime budget (account currency), bid, optimisation goal, targeting and schedule.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idOptional | string | — |
adset_idsOptional | array<string> | — |
list_meta_instagram_posts
Lesen1 CreditsRecent Instagram posts of the connected Instagram business account with likes, comments and engagement, sorted by engagement — to pick a post to boost.
| Parameter | Typ | Beschreibung |
|---|---|---|
instagram_user_idOptional | string | — |
limitOptional | integer (1–100) | — |
sort_byOptional | engagement | recent | — |
list_meta_lead_forms
Lesen1 CreditsLead (instant) forms of the Facebook Page with status and lead counts. Creating new lead forms is not supported.
| Parameter | Typ | Beschreibung |
|---|---|---|
page_idOptional | string | — |
meta_lead_form_summary
Lesen2 CreditsLead counts for one lead form over the last N days, by day, by ad and by platform. Counts only; personal answers are never returned.
| Parameter | Typ | Beschreibung |
|---|---|---|
form_idPflicht | string | — |
page_idOptional | string | — |
daysOptional | integer (1–90) | — |
Schreib-Tools11 Tools
select_meta_ad_account
Schreiben1 CreditsChoose which Meta ad account all further Meta tools work in (agency / multi-account). Only accounts the user can access are accepted.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idPflicht | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_website_audience
Schreiben2 CreditsCreate a website custom audience from the Meta pixel (e.g. added to cart in the last 30 days but did not purchase). Preview and approval first; the audience populates within hours.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
eventPflicht | string | pixel event: AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView … |
retention_daysOptional | integer (1–180) | — |
exclude_eventOptional | string | e.g. Purchase for cart abandoners |
pixel_idOptional | string | — |
descriptionOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_lookalike_audience
Schreiben2 CreditsCreate a Meta lookalike audience (1–10%) of a custom audience in one or more countries. Preview and approval first.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
source_audience_idPflicht | string | — |
countriesPflicht | array<string> | ISO codes |
ratio_percentOptional | number (1–10) | 1 = closest 1% |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_campaign
Schreiben2 CreditsCreate a Meta campaign end to end (campaign + ad set + ad when a page and creative exist) as a paused draft with objective, daily budget and targeting. Writes a ledger draft and an approval item; sent to Meta only after approval.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
objectivePflicht | sales | traffic | engagement | messages | awareness | — |
daily_budgetOptional | number | account currency |
goalOptional | string | — |
audienceOptional | object | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_meta_campaign
Schreiben2 CreditsChange a Meta campaign's budget (daily/lifetime), status, name, bid strategy or spend cap. Preview with before → after; budget increases above +50% per step are blocked. Applied only after approval.
| Parameter | Typ | Beschreibung |
|---|---|---|
campaign_idPflicht | string | Meta campaign id or Tecrube campaign id |
daily_budgetOptional | number | — |
lifetime_budgetOptional | number | — |
statusOptional | ACTIVE | PAUSED | ARCHIVED | — |
nameOptional | string | — |
bid_strategyOptional | string | LOWEST_COST_WITHOUT_CAP | LOWEST_COST_WITH_BID_CAP | COST_CAP | LOWEST_COST_WITH_MIN_ROAS |
spend_capOptional | number | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_meta_ad_set
Schreiben2 CreditsChange a Meta ad set's budget, status, targeting (locations, age, gender, interests, audiences, placements), bid or schedule. Preview and approval first; the budget guardrail applies.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
daily_budgetOptional | number | — |
lifetime_budgetOptional | number | — |
statusOptional | ACTIVE | PAUSED | ARCHIVED | — |
nameOptional | string | — |
bid_strategyOptional | string | — |
bid_amountOptional | number | — |
targetingOptional | object | — |
start_timeOptional | string | ISO 8601 |
end_timeOptional | string | ISO 8601 |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
duplicate_meta_ad_set
Schreiben2 CreditsDuplicate a winning Meta ad set (with its ads) as a paused copy and give it a new interest audience, targeting or budget for a test. Preview and approval first.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
interest_idsOptional | array<string> | replace interests, keep the rest of the targeting |
targetingOptional | object | — |
daily_budgetOptional | number | — |
nameOptional | string | — |
bid_amountOptional | number | — |
start_timeOptional | string | — |
end_timeOptional | string | — |
deep_copyOptional | boolean | — |
rename_suffixOptional | string | — |
target_campaign_idOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
pause_meta_ad_sets_above_cpa
Schreiben2 CreditsFind active Meta ad sets whose CPA is above a threshold (or that spent at least the threshold with zero results), pause them in one action and move their freed daily budget to the best-CPA ad set within the +50% guardrail. Shows the list first; applied only after approval.
| Parameter | Typ | Beschreibung |
|---|---|---|
cpa_thresholdPflicht | number | account currency |
conversion_eventOptional | purchase | lead | add_to_cart | complete_registration | messaging | link_click | result type used for conversions and CPA (default purchase) |
daysOptional | integer (1–1125) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
min_spendOptional | number | — |
campaign_idsOptional | array<string> | — |
reallocateOptional | boolean | move the paused sets' daily budget to the best ad set (default true) |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_carousel_ad
Schreiben2 CreditsCreate a Meta carousel ad (2–10 image cards, e.g. five product images) in an ad set for Facebook and Instagram. Studio images are uploaded to Meta (adimages). Created paused after approval.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
nameOptional | string | — |
linkPflicht | string | — |
messageOptional | string | primary text |
cardsPflicht | array<object> | — |
call_to_actionOptional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
optimize_card_orderOptional | boolean | — |
page_idOptional | string | — |
instagram_user_idOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_meta_video_ad
Schreiben2 CreditsCreate a Meta video ad from an existing video id in an ad set (thumbnail taken from the video when not given). Created paused after approval.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
video_idPflicht | string | video id in the Meta ad account |
linkPflicht | string | — |
nameOptional | string | — |
messageOptional | string | — |
titleOptional | string | — |
call_to_actionOptional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
thumbnail_urlOptional | string | — |
page_idOptional | string | — |
instagram_user_idOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
boost_instagram_post
Schreiben2 CreditsTurn an existing Instagram post (source_instagram_media_id) or Facebook Page post (object_story_id) into an ad in an ad set; pick_best chooses the most engaging recent Instagram post. Preview and approval first; created paused.
| Parameter | Typ | Beschreibung |
|---|---|---|
adset_idPflicht | string | — |
instagram_media_idOptional | string | — |
pick_bestOptional | boolean | use the most engaging recent Instagram post |
lookback_postsOptional | integer (1–100) | — |
facebook_post_idOptional | string | {page_id}_{post_id} to boost a Page post instead |
linkOptional | string | — |
call_to_actionOptional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
nameOptional | string | — |
instagram_user_idOptional | string | — |
page_idOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.