Meta tools
Facebook and Instagram campaigns, ad sets, audiences, creatives, lead form results and reach estimates.
A integração deste canal está pronta; a ligação abre assim que a plataforma aprovar a nossa aplicação de programador. Até lá, não é possível ligar contas e as ações descritas nesta página não estão disponíveis.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools32 tools
list_meta_ad_accounts
Leitura1 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.
This tool takes no parameters.
meta_insights_report
Leitura2 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 | Type | Description |
|---|---|---|
levelOptional | campaign | adset | ad | — |
daysOptional | integer (1–1125) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
date_presetOptional | today | yesterday | last_7d | last_14d | last_28d | last_30d | last_90d | this_month | last_month | instead of days/start_date/end_date |
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 | app_install | 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) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_top_creatives
Leitura2 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 | Type | Description |
|---|---|---|
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 | app_install | 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> | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_audiences
Leitura1 creditsCustom and lookalike audiences of the Meta ad account: id, name, subtype, approximate size range, retention, delivery status.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
search_meta_interests
Leitura1 creditsSearch Meta detailed targeting by keyword: interests (default) or behaviours, life events, industries, family statuses, income and demographics — id, name, path and audience size range. Use the ids in targeting.interest_ids / behavior_ids / life_event_ids …
| Parameter | Type | Description |
|---|---|---|
queryOptional | string | — |
limitOptional | integer (1–100) | — |
localeOptional | string | e.g. tr_TR, en_US |
kindOptional | interest | behavior | life_event | industry | family_status | income | demographic | interest (default) or a detailed-targeting category |
category_classOptional | string | raw adTargetingCategory class, overrides kind |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_reach_estimate
Leitura2 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 | Type | Description |
|---|---|---|
targetingRequired | object | — |
optimization_goalOptional | string | REACH (default), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS … |
pixel_idOptional | string | — |
custom_event_typeOptional | string | e.g. PURCHASE (with pixel_id) |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_ad_sets
Leitura1 creditsMeta ad sets with status, daily/lifetime budget (account currency), bid, optimisation goal, targeting and schedule.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | — |
adset_idsOptional | array<string> | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_instagram_posts
Leitura1 creditsRecent Instagram posts of the connected Instagram business account with likes, comments and engagement, sorted by engagement — to pick a post to boost.
| Parameter | Type | Description |
|---|---|---|
instagram_user_idOptional | string | — |
limitOptional | integer (1–100) | — |
sort_byOptional | engagement | recent | — |
list_meta_conversations
Leitura1 creditsMessenger or Instagram Direct conversations of the Facebook Page (and its linked Instagram account): participants, unread count, last message preview. Read only; reply with reply_customer.
| Parameter | Type | Description |
|---|---|---|
page_idOptional | string | — |
platformOptional | messenger | instagram | — |
limitOptional | integer (1–50) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_lead_forms
Leitura1 creditsLead (instant) forms of the Facebook Page with status and lead counts. Create one with create_meta_lead_form.
| Parameter | Type | Description |
|---|---|---|
page_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_lead_form_summary
Leitura2 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 | Type | Description |
|---|---|---|
form_idRequired | string | — |
page_idOptional | string | — |
daysOptional | integer (1–90) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_catalogs
Leitura1 creditsProduct catalogs owned by the user's Meta businesses (Commerce Manager): id, name, product count, vertical, business. Needs catalog_management; connected=false when Meta is not linked.
| Parameter | Type | Description |
|---|---|---|
business_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_catalog_products
Leitura1 creditsProducts of a Meta catalog with retailer id, price, availability, condition, URL, image, review status and rejection reasons; filter by review status or Graph filter. Read only.
| Parameter | Type | Description |
|---|---|---|
catalog_idRequired | string | Meta product catalog id (list_meta_catalogs) |
queryOptional | string | name contains |
review_statusOptional | approved | rejected | pending | outdated | — |
filterOptional | object | Graph product filter, e.g. {"retailer_id": {"eq": "SKU1"}} |
limitOptional | integer (1–1000) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_product_sets
Leitura1 creditsProduct sets of a Meta catalog (id, name, product count, filter) for catalog sales ad sets, plus the catalog's product feeds with their latest upload result. Read only.
| Parameter | Type | Description |
|---|---|---|
catalog_idRequired | string | Meta product catalog id (list_meta_catalogs) |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_pages
Leitura1 creditsFacebook Pages the connected Meta user manages (id, name, category, tasks, linked Instagram account) or, with promotable_only, the Pages the ad account can advertise for. Read only.
| Parameter | Type | Description |
|---|---|---|
promotable_onlyOptional | boolean | only Pages the selected ad account can promote |
list_meta_campaigns
Leitura1 creditsCampaigns live in the Meta ad account (including ones made outside this app): id, name, status, objective, daily/lifetime budget in account currency, bid strategy, schedule. Read only.
| Parameter | Type | Description |
|---|---|---|
effective_statusOptional | array<string> | e.g. ACTIVE, PAUSED |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_ads
Leitura1 creditsMeta ads of the account, an ad set or a campaign: id, name, status, effective status, ad set, creative id and thumbnail. Read only.
| Parameter | Type | Description |
|---|---|---|
adset_idOptional | string | — |
campaign_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_page_posts
Leitura1 creditsRecent posts of a Facebook Page with text, picture and permalink, to reuse an organic post as an ad (object_story_id). Read only.
| Parameter | Type | Description |
|---|---|---|
page_idOptional | string | — |
limitOptional | integer (1–100) | — |
list_meta_pixels
Leitura1 creditsMeta pixels (datasets) of the ad account with name and last fired time. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_insights_query
Leitura2 creditsFree-form read of the Meta Insights API for anything the ready reports don't cover: any field, breakdown, action breakdown, filter and time increment Meta supports. Returns raw rows. Read only.
| Parameter | Type | Description |
|---|---|---|
fieldsRequired | array<string> | Insights fields, e.g. spend, reach, actions, video_p75_watched_actions |
levelOptional | account | campaign | adset | ad | — |
breakdownsOptional | array<string> | e.g. age, gender, country, publisher_platform, hourly_stats_aggregated_by_advertiser_time_zone |
action_breakdownsOptional | array<string> | e.g. action_type, action_device |
daysOptional | integer (1–1125) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
time_incrementOptional | string | 1 = daily, 7 = weekly, monthly, all_days |
filteringOptional | array<object> | Graph filters [{field, operator, value}] |
limitOptional | integer (1–5000) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_instagram_accounts
Leitura1 creditsInstagram accounts usable for ads: those attached to the ad account and those linked to the user's Facebook Pages (id, username, page). Read only.
This tool takes no parameters.
list_meta_saved_audiences
Leitura1 creditsSaved audiences (reusable targeting presets from Ads Manager) with targeting and approximate size. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_custom_conversions
Leitura1 creditsCustom conversions of the ad account: id, name, rule (URL / event), event type, pixel, last fired, default value. Read only.
| Parameter | Type | Description |
|---|---|---|
include_archivedOptional | boolean | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
diagnose_meta_delivery
Leitura2 creditsLIVE delivery diagnosis of one Meta campaign — call it first when the user reports a status or warning (not delivering, with issues, learning, limited, rejected). Returns the campaign, its ad sets and ads with effective status, the issues Meta reports as blocking delivery (issues_info: level, error code, summary, message), each ad set's learning stage, bid strategy / bid amount / budget and budget remaining, and each ad's review feedback, plus a findings list. Read only.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Meta campaign id (list_meta_campaigns) or Tecrübe campaign id |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_change_history
Leitura2 creditsActivity history of the Meta ad account: who changed what and when (budget, status, targeting, creative edits), with old/new values when Meta provides them. Read only.
| Parameter | Type | Description |
|---|---|---|
sinceOptional | string | YYYY-MM-DD |
untilOptional | string | YYYY-MM-DD |
daysOptional | integer (1–365) | — |
levelOptional | string | filter by object type: campaign | adset | ad | account … |
limitOptional | integer (1–1000) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_delivery_estimate
Leitura1 creditsMeta's delivery estimate for an existing ad set's current targeting: reachable monthly users, daily users and the expected-results curve, without spending. Read only.
| Parameter | Type | Description |
|---|---|---|
adset_idRequired | string | — |
optimization_goalOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
preview_meta_ad
Leitura1 creditsRender a preview of a Meta creative or ad in a placement format (feed, story, reels …) without publishing; returns a temporary preview URL. Read only.
| Parameter | Type | Description |
|---|---|---|
creative_idOptional | string | — |
ad_idOptional | string | — |
ad_formatOptional | DESKTOP_FEED_STANDARD | MOBILE_FEED_STANDARD | INSTAGRAM_STANDARD | INSTAGRAM_STORY | INSTAGRAM_REELS | FACEBOOK_STORY_MOBILE | FACEBOOK_REELS_MOBILE | RIGHT_COLUMN_STANDARD | MARKETPLACE_MOBILE | AUDIENCE_NETWORK_OUTSTREAM_VIDEO | MESSENGER_MOBILE_INBOX_MEDIA | INSTAGRAM_EXPLORE_GRID_HOME | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
get_meta_ad_creative
Leitura1 creditsRead an ad's current creative: headline, primary text, description, image or video, button, destination link, Page / Instagram identity and which Advantage+ creative features are enrolled. Read only.
| Parameter | Type | Description |
|---|---|---|
ad_idRequired | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
find_instagram_media_id
Leitura1 creditsResolve an Instagram post or Reel link to its media id (needed for boost_instagram_post) by scanning the selected Instagram business account's media. Read only.
| Parameter | Type | Description |
|---|---|---|
urlRequired | string | — |
ig_user_idOptional | string | — |
instagram_follower_growth
Leitura1 creditsDaily new followers of an Instagram business account over the last up to 30 days plus the current follower count, to measure follower and profile-visit campaigns. Read only.
| Parameter | Type | Description |
|---|---|---|
ig_user_idOptional | string | — |
daysOptional | integer (1–30) | — |
download_meta_leads
Leitura1 creditsDownload the answers submitted through a Meta instant form (every question, plus the ad, ad set and campaign of each lead). Personal data: needs leads_retrieval; handle under the form's consent. Read only.
| Parameter | Type | Description |
|---|---|---|
form_idRequired | string | — |
page_idOptional | string | — |
limitOptional | integer (1–2000) | — |
sinceOptional | string | YYYY-MM-DD |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_targeting_helper
Leitura1 creditsThree helpers while building Meta targeting: suggest interests close to the ones you have, check whether an interest id or name is still usable (an ad set carrying an invalid one is rejected), or read the account's minimum daily budgets. Read only.
| Parameter | Type | Description |
|---|---|---|
modeOptional | suggest | validate | minimum_budget | — |
interest_idsOptional | array<string> | — |
namesOptional | array<string> | — |
limit_typeOptional | interests | behaviors | income | life_events | — |
is_exclusionOptional | boolean | — |
bid_amountOptional | integer | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tools38 tools
select_meta_ad_account
Escrita1 creditsChoose which Meta ad account all further Meta tools work in (agency / multi-account). Only accounts the user can access are accepted.
| Parameter | Type | Description |
|---|---|---|
account_idRequired | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_website_audience
Escrita2 creditsCreate a website custom audience from the Meta pixel (e.g. added to cart in the last 30 days but did not purchase). Applied directly when the user asks; the audience populates within hours.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
eventRequired | 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 | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_lookalike_audience
Escrita2 creditsCreate a Meta lookalike audience (1–10%) of a custom audience in one or more countries. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
source_audience_idRequired | string | — |
countriesRequired | array<string> | ISO codes |
ratio_percentOptional | number (1–10) | 1 = closest 1% |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_campaign
Escrita2 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 sends it to Meta directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
objectiveRequired | sales | traffic | engagement | messages | awareness | — |
daily_budgetOptional | number | account currency |
goalOptional | string | — |
special_ad_categoriesOptional | array<string> | CREDIT | EMPLOYMENT | HOUSING | ISSUES_ELECTIONS_POLITICS | FINANCIAL_PRODUCTS_SERVICES |
audienceOptional | object | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_meta_campaign
Escrita2 creditsChange a Meta campaign's budget (daily/lifetime), status, name, bid strategy or spend cap. Applied directly when the user asks; the result shows before → after; budget increases above +50% per step are blocked.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Meta campaign id or Tecrube campaign id |
daily_budgetOptional | number | ad account currency |
lifetime_budgetOptional | number | — |
currencyOptional | string | optional ISO check; must equal the ad account currency |
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 | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_meta_ad_set
Escrita2 creditsChange a Meta ad set's budget, status, targeting (locations, age, gender, interests, audiences, placements), bid or schedule. Applied directly when the user asks; the budget guardrail applies.
| Parameter | Type | Description |
|---|---|---|
adset_idRequired | string | — |
daily_budgetOptional | number | ad account currency |
lifetime_budgetOptional | number | — |
currencyOptional | string | optional ISO check; must equal the ad account currency |
statusOptional | ACTIVE | PAUSED | ARCHIVED | — |
nameOptional | string | — |
bid_strategyOptional | string | — |
bid_amountOptional | number | — |
targetingOptional | object | — |
start_timeOptional | string | ISO 8601 |
end_timeOptional | string | ISO 8601 |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
duplicate_meta_ad_set
Escrita2 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. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
adset_idRequired | 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 | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
pause_meta_ad_sets_above_cpa
Escrita2 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 directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
cpa_thresholdRequired | number | account currency |
conversion_eventOptional | purchase | lead | add_to_cart | complete_registration | messaging | app_install | 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) |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_carousel_ad
Escrita2 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.
| Parameter | Type | Description |
|---|---|---|
adset_idRequired | string | — |
nameOptional | string | — |
linkRequired | string | — |
messageOptional | string | primary text |
cardsRequired | 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 | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_video_ad
Escrita2 creditsCreate a Meta video ad in an ad set from a video id already in the ad account or a public video URL that Meta fetches (thumbnail taken from the video when not given). Created paused.
| Parameter | Type | Description |
|---|---|---|
adset_idRequired | string | — |
video_idOptional | string | video id in the Meta ad account |
video_urlOptional | string | public https video URL; Meta fetches it (instead of video_id) |
linkRequired | 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 | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
boost_instagram_post
Escrita2 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. Applied directly when the user asks; created paused.
| Parameter | Type | Description |
|---|---|---|
adset_idRequired | 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 | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
upsert_meta_catalog_product
Escrita2 creditsAdd a product to a Meta catalog (POST /{catalog_id}/products; needs retailer_id, name, url, image_url, price, currency, availability) or update an existing one (POST /{product_id}). Applied directly when the user asks; applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
catalog_idOptional | string | Meta product catalog id (list_meta_catalogs) |
product_idOptional | string | existing Meta product id to update; omit to create |
retailer_idOptional | string | — |
nameOptional | string | — |
descriptionOptional | string | — |
urlOptional | string | — |
image_urlOptional | string | — |
priceOptional | number | — |
sale_priceOptional | number | — |
currencyOptional | string | ISO; default: ad account currency |
availabilityOptional | in stock | out of stock | preorder | available for order | discontinued | — |
conditionOptional | new | refurbished | used | — |
brandOptional | string | — |
categoryOptional | string | — |
gtinOptional | string | — |
colorOptional | string | — |
sizeOptional | string | — |
item_group_idOptional | string | — |
custom_label_0Optional | string | — |
visibilityOptional | published | staging | — |
custom_label_1Optional | string | — |
custom_label_2Optional | string | — |
custom_label_3Optional | string | — |
custom_label_4Optional | string | — |
genderOptional | string | female | male | unisex |
materialOptional | string | — |
patternOptional | string | — |
product_typeOptional | string | seller's own category path |
additional_image_urlsOptional | array<string> | extra product image URLs |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_catalog_sales_campaign
Escrita2 creditsCreate a Meta catalog sales campaign (objective OUTCOME_SALES with promoted_object.product_catalog_id) and an ad set promoting a product set (promoted_object.product_set_id, purchase optimisation) as a paused draft. Writes a ledger draft and sends it to Meta directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
catalog_idRequired | string | Meta product catalog id (list_meta_catalogs) |
product_set_idRequired | string | — |
daily_budgetOptional | number | account currency |
countriesOptional | array<string> | ISO codes, default TR |
pixel_idOptional | string | — |
goalOptional | string | — |
audienceOptional | object | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
meta_page_subscription
Escrita1 creditsWhether the Facebook Page is subscribed to Tecrübe's webhook (new Messenger / Instagram messages and lead form answers arrive only then) and which fields; subscribe=true sets the subscription up (safe to repeat). Needs pages_manage_metadata.
| Parameter | Type | Description |
|---|---|---|
page_idOptional | string | — |
subscribeOptional | boolean | true = subscribe the Page now |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
delete_meta_campaign
EscritaIrreversible5 creditsPERMANENTLY delete a Meta campaign (reports stay readable in Meta). Only call it when the user explicitly asked for it; it is applied at once and cannot be undone; pause instead if unsure.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
delete_meta_adset
EscritaIrreversible5 creditsPERMANENTLY delete a Meta ad set. Only call it when the user explicitly asked for it; it is applied at once and cannot be undone.
| Parameter | Type | Description |
|---|---|---|
adset_idRequired | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
delete_meta_ad
EscritaIrreversible5 creditsPERMANENTLY delete a Meta ad. Only call it when the user explicitly asked for it; it is applied at once and cannot be undone.
| Parameter | Type | Description |
|---|---|---|
ad_idRequired | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
delete_meta_audience
EscritaIrreversible5 creditsPERMANENTLY delete a Meta custom or lookalike audience (duplicates, mistakes, privacy requests). Only call it when the user explicitly asked for it; it is applied at once and cannot be undone.
| Parameter | Type | Description |
|---|---|---|
audience_idRequired | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_adset
Escrita5 creditsCreate a paused ad set in an existing Meta campaign with optimisation goal, budget, bid, schedule, promoted object and full targeting (locations, demographics, detailed targeting, audiences, placements). Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | — |
nameRequired | string | — |
optimization_goalOptional | LINK_CLICKS | LANDING_PAGE_VIEWS | OFFSITE_CONVERSIONS | REACH | IMPRESSIONS | LEAD_GENERATION | CONVERSATIONS | THRUPLAY | POST_ENGAGEMENT | VALUE | QUALITY_LEAD | APP_INSTALLS | PROFILE_VISIT | — |
billing_eventOptional | IMPRESSIONS | LINK_CLICKS | THRUPLAY | — |
daily_budgetOptional | number | account currency |
lifetime_budgetOptional | number | — |
bid_strategyOptional | string | — |
bid_amountOptional | number | — |
targetingRequired | object | — |
start_timeOptional | string | ISO 8601 |
end_timeOptional | string | ISO 8601 |
pixel_idOptional | string | — |
custom_event_typeOptional | string | — |
page_idOptional | string | — |
destination_typeOptional | string | e.g. WEBSITE, MESSENGER, WHATSAPP, ON_AD |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
copy_meta_entity
Escrita5 creditsDuplicate a Meta campaign, ad set or ad (Ads Manager 'Duplicate'), optionally with its children and into another parent; the copy is always paused. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
kindRequired | campaign | adset | ad | — |
entity_idRequired | string | — |
deep_copyOptional | boolean | — |
rename_prefixOptional | string | — |
rename_suffixOptional | string | — |
target_parent_idOptional | string | campaign for an ad set copy, ad set for an ad copy |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_link_ad
Escrita8 creditsCreate a single-image Meta link ad (creative + ad) in an ad set from an image URL, uploaded image hash or base64 image, with primary text, headline and button. Created paused.
| Parameter | Type | Description |
|---|---|---|
adset_idRequired | string | — |
nameOptional | string | — |
linkRequired | string | — |
messageOptional | string | primary text |
headlineOptional | string | — |
descriptionOptional | string | — |
image_urlOptional | string | public https image URL or Studio media URL |
image_hashOptional | string | from upload_meta_image |
image_base64Optional | string | base64 image, at most 5 MB |
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 | — |
page_idOptional | string | — |
instagram_user_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_dynamic_ad
Escrita8 creditsCreate a dynamic product ad that fills itself from a catalog product set ({{product.name}}, {{product.price}}) in a catalog sales ad set. Created paused.
| Parameter | Type | Description |
|---|---|---|
adset_idRequired | string | — |
nameOptional | string | — |
product_set_idRequired | string | — |
messageOptional | string | — |
descriptionOptional | string | template text, default {{product.price}} |
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 | — |
fallback_linkOptional | string | — |
page_idOptional | string | — |
instagram_user_idOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_meta_ad
Escrita5 creditsPause, resume, archive or rename one Meta ad. Applied directly when the user asks; the result shows before → after.
| Parameter | Type | Description |
|---|---|---|
ad_idRequired | string | — |
statusOptional | ACTIVE | PAUSED | ARCHIVED | — |
nameOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_meta_ad_creative
Escrita5 creditsReplace a link ad's creative (image, text, link, button) without deleting the ad: a new creative is built from the current one plus your changes and swapped in, so the ad keeps its id and history. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
ad_idRequired | string | — |
messageOptional | string | — |
headlineOptional | string | — |
descriptionOptional | string | — |
linkOptional | string | — |
image_urlOptional | string | public https image URL or Studio media URL |
image_hashOptional | string | from upload_meta_image |
image_base64Optional | string | base64 image, at most 5 MB |
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 | — |
page_idOptional | string | — |
nameOptional | string | new creative name |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_ab_test
Escrita5 creditsCreate a Meta split test that runs two existing campaigns 50/50 on non-overlapping audiences for a period and reports a fair winner. Needs a Business Manager. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
campaign_aRequired | string | — |
campaign_bRequired | string | — |
start_timeRequired | string | ISO 8601 (UTC if no offset) |
end_timeRequired | string | ISO 8601 |
control_nameOptional | string | — |
treatment_nameOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
manage_meta_account_controls
Escrita2 creditsAccount-level brand safety: read or set the audience and placement constraints that bind EVERY campaign in the Meta ad account (minimum age, excluded countries, excluded placements such as Audience Network or Marketplace). Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
actionOptional | get | set | — |
age_minOptional | integer (13–65) | — |
placement_exclusionsOptional | array<string> | AUDIENCE_NETWORK_CLASSIC | AUDIENCE_NETWORK_REWARDED_VIDEO | AUDIENCE_NETWORK_INSTREAM_VIDEO | FACEBOOK_MARKETPLACE | FACEBOOK_RIGHT_HAND_COLUMN |
countriesOptional | array<string> | — |
excluded_countriesOptional | array<string> | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_product_set
Escrita2 creditsCreate a product set on a Meta catalog from a rule (brand, product_type, price, availability, custom labels…), to use as the product set of a catalog sales ad set. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
catalog_idRequired | string | — |
nameRequired | string | — |
filterOptional | object | rule, e.g. {"product_type": {"i_contains": "shirt"}}; {} = all products |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_customer_file_audience
Escrita5 creditsCreate a Meta custom audience from a customer list (customaudiences + users). Values are normalised and SHA-256 hashed inside Tecrübe before anything is stored or sent; the preview shows only counts. The ad account must have accepted the Custom Audience Terms. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
id_typeOptional | EMAIL | PHONE | EXTERN_ID | — |
identifiersRequired | array<string> | emails, phones with country code or your own customer ids; already SHA-256 hashed values are accepted too |
descriptionOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_product_audience
Escrita5 creditsCreate a Meta catalog retargeting audience from a product set (e.g. viewed a product in the last 30 days but did not buy). Use it as the audience of a catalog sales ad set. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
product_set_idRequired | string | — |
eventOptional | string | ViewContent | AddToCart | Purchase (default ViewContent) |
exclude_eventOptional | string | default Purchase; empty string to exclude nothing |
retention_daysOptional | integer (1–180) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_pixel
Escrita2 creditsCreate a new Meta pixel (dataset) on the ad account and return its pixel_id to install on the website. Check list_meta_pixels first: Meta limits how many pixels an account may have. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_custom_conversion
Escrita2 creditsCreate a custom conversion on a Meta pixel from a URL rule and/or an event (e.g. URL contains /thank-you). Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
pixel_idOptional | string | — |
url_containsOptional | string | — |
eventOptional | string | pixel event, e.g. PageView, Purchase |
custom_event_typeOptional | PURCHASE | LEAD | COMPLETE_REGISTRATION | ADD_TO_CART | INITIATED_CHECKOUT | ADD_PAYMENT_INFO | CONTENT_VIEW | SEARCH | ADD_TO_WISHLIST | CONTACT | SUBSCRIBE | START_TRIAL | SUBMIT_APPLICATION | SCHEDULE | OTHER | — |
default_conversion_valueOptional | number | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_meta_custom_conversion
Escrita2 creditsRename a Meta custom conversion or change its description / default value. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
conversion_idRequired | string | — |
nameOptional | string | — |
descriptionOptional | string | — |
default_conversion_valueOptional | number | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_engagement_audience
Escrita5 creditsCreate a Meta retargeting audience from engagement with a Facebook Page, an Instagram business profile or a lead form (e.g. opened but didn't submit). Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
sourceRequired | page | instagram | lead_form | — |
source_idOptional | string | — |
eventOptional | string | e.g. page_engaged, ig_business_profile_engaged, lead_generation_opened |
retention_daysOptional | integer (1–730) | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_lead_form
Escrita5 creditsCreate an instant (lead) form on a Facebook Page with standard and custom questions, intro, privacy policy and thank-you screen; returns the form id for a lead ad. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
page_idOptional | string | — |
nameRequired | string | — |
privacy_policy_urlRequired | string | — |
questionsRequired | array<object> | — |
follow_up_urlOptional | string | — |
intro_headlineOptional | string | — |
intro_descriptionOptional | string | — |
thank_you_textOptional | string | — |
localeOptional | string | e.g. tr_TR |
higher_intentOptional | boolean | add a review step (higher-intent form) |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
upload_meta_image
Escrita1 creditsUpload an image to the Meta ad account image library and get its image_hash for reuse across ads. External URLs are fetched only from the public internet. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
image_urlOptional | string | public https image URL or Studio media URL |
image_base64Optional | string | base64 image, at most 5 MB |
nameOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
upload_meta_video
Escrita3 creditsAdd a video to the Meta ad account from a public URL (Meta fetches it) and get its video_id for create_meta_video_ad. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
video_urlRequired | string | public https video URL; Meta fetches it |
nameOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
send_meta_conversion_event
Escrita1 creditsSend a server-side conversion event to Meta (Conversions API), e.g. an offline or CRM sale. Email, phone and external id are SHA-256 hashed before they are stored or sent. Use test_event_code to check in Events Manager first. Applied directly when the user asks.
| Parameter | Type | Description |
|---|---|---|
pixel_idOptional | string | — |
event_nameRequired | string | — |
emailOptional | string | — |
phoneOptional | string | — |
external_idOptional | string | — |
valueOptional | number | — |
currencyOptional | string | — |
event_idOptional | string | deduplication id shared with the pixel |
event_source_urlOptional | string | — |
action_sourceOptional | website | app | phone_call | chat | email | physical_store | system_generated | business_messaging | other | — |
fbcOptional | string | — |
fbpOptional | string | — |
test_event_codeOptional | string | — |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_meta_ad_account
EscritaIrreversible2 creditsCreate a new Meta ad account under the user's Business Manager (for the user who has no ad account after OAuth). Needs a Business Manager (returns an honest note if none; lists them when there are several). Only call it when the user explicitly asked for it; the account is created at once and the connection is linked to it. Currency and time zone are permanent; a payment method must still be added in Business Manager.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | account name, e.g. “Acme Ads” |
currencyRequired | string | permanent; Meta-supported ISO code (TRY, USD, EUR…) |
business_idOptional | string | Business Manager id the account belongs to; required when the user has several |
connection_idOptional | string | optional: which Meta identity (connection) opens the account |
forceOptional | boolean | create even though this identity already has an ad account |
account_idOptional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.