본문으로 건너뛰기
Tecrübetecrube.com
Assistant tools · Setup and campaigns

X Ads tools

X (Twitter) ad accounts and campaigns, daily budget and status changes; every change can be undone.

Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.

Read tools8 tools

list_x_ads_accounts

읽기1 credits

X (Twitter) Ads accounts reachable through the connected X login: account_id, name, currency, approval status and which one is selected. Read only; connected=false when X isn't connected.

This tool takes no parameters.

list_x_campaigns

읽기1 credits

X Ads campaigns of the account: id, name, status, daily and total budget (account currency), funding instrument, schedule and serving issues. Read only; never invents numbers.

ParameterTypeDescription
account_idOptionalstringX ad account id; defaults to the connection's selected account
statusOptionalactive | paused | draft—

x_performance_report

읽기1 credits

X Ads performance per campaign for the last N days: spend, impressions, clicks, link clicks, engagements, CTR and CPC, plus totals (account currency and time zone). Read only; never invents numbers.

ParameterTypeDescription
account_idOptionalstringX ad account id; defaults to the connection's selected account
daysOptionalinteger (1–90)last N days including today (default 7)
campaign_idsOptionalarray<string>limit to these campaigns (default: all)

list_x_assets

읽기1 credits

List X Ads account objects by kind: funding_instruments, line_items, promoted_tweets, targeting_criteria, tweets, media_library, account_media, cards, custom_audiences, web_event_tags, promotable_users and more. Read only.

ParameterTypeDescription
account_idOptionalstring—
kindRequiredfunding_instruments | line_items | promoted_tweets | targeting_criteria | media_library | account_media | cards | custom_audiences | web_event_tags | scheduled_tweets | draft_tweets | account_apps | promotable_users | features | authenticated_user_access | tweets—
line_item_idOptionalstring—
campaign_idOptionalstring—
tweet_typeOptionalstring—
timeline_typeOptionalstring—

x_details

읽기1 credits

Full details of one X Ads object: campaign, line_item, promoted_tweet, targeting_criterion, funding_instrument, custom_audience, web_event_tag, card or media. Read only.

ParameterTypeDescription
account_idOptionalstring—
kindRequiredstring—
idRequiredstring—

x_audience_estimate

읽기1 credits

Estimate the X Ads audience size for targeting criteria. Sends nothing live. Read only.

ParameterTypeDescription
account_idOptionalstring—
targeting_criteriaRequiredarray<object>—
objectiveOptionalstring—

diagnose_x_delivery

읽기1 credits

Why an X Ads campaign isn't delivering: funding source, servability reasons, missing ad groups or promoted posts and ad approvals, ordered by urgency. Read only.

ParameterTypeDescription
account_idOptionalstring—
campaign_idOptionalstring—

Write tools12 tools

update_x_campaign_status

쓰기2 credits

Pause or activate an X Ads campaign. Applied when the user asks, recorded in the audit log and undoable with undo_action.

ParameterTypeDescription
account_idOptionalstringX ad account id; defaults to the connection's selected account
campaign_idRequiredstring—
statusRequiredpause | activate—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_x_campaign_budget

쓰기2 credits

Set an X Ads campaign daily budget (account currency). Increases above 50% per change or 2x per 24 hours are blocked; undoable with undo_action.

ParameterTypeDescription
account_idOptionalstringX ad account id; defaults to the connection's selected account
campaign_idRequiredstring—
daily_budgetRequirednumbernew daily budget in the account currency

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

upload_x_image

쓰기2 credits

Upload an image from a URL (including generated Studio images, up to 5 MB) to X and its ad media library; returns media_key for create_x_tweet.

ParameterTypeDescription
account_idOptionalstring—
image_urlRequiredstring—
nameOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_x_campaign

쓰기2 credits

Create an X Ads campaign, always paused. Next: create_x_line_item, manage_x_targeting, create_x_tweet, promote_x_tweets, x_status(activate). Undo deletes it.

ParameterTypeDescription
account_idOptionalstring—
nameRequiredstring—
daily_budgetRequirednumberaccount currency
total_budgetOptionalnumberaccount currency
funding_instrument_idOptionalstring—
purchase_order_numberOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_x_campaign

쓰기2 credits

Update an X Ads campaign's name, total budget (50% per-step limit) or purchase order. Daily budgets use update_x_campaign_budget. Undoable with undo_action.

ParameterTypeDescription
account_idOptionalstring—
campaign_idRequiredstring—
nameOptionalstring—
total_budgetOptionalnumberaccount currency
purchase_order_numberOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_x_line_item

쓰기2 credits

Create a paused X Ads ad group (line item) with objective, placements, bid, budget and schedule. Add targeting with manage_x_targeting. Undo deletes it.

ParameterTypeDescription
account_idOptionalstring—
campaign_idRequiredstring—
nameRequiredstring—
objectiveOptionalAPP_ENGAGEMENTS | APP_INSTALLS | REACH | FOLLOWERS | ENGAGEMENTS | VIDEO_VIEWS | PREROLL_VIEWS | WEBSITE_CLICKS—
goalOptionalstring—
placementsOptionalarray<string>—
product_typeOptionalstring—
bid_strategyOptionalAUTO | MAX | TARGET—
bid_amountOptionalnumberaccount currency
daily_budgetOptionalnumberaccount currency
total_budgetOptionalnumberaccount currency
start_timeOptionalstringISO 8601 UTC
end_timeOptionalstringISO 8601 UTC
advertiser_domainOptionalstring—
categoriesOptionalarray<string>—
primary_web_event_tagOptionalstring—
android_app_store_identifierOptionalstring—
ios_app_store_identifierOptionalstring—
audience_expansionOptionalstring—
pay_byOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_x_line_item

쓰기2 credits

Update an X Ads ad group: name, bid, budget, schedule or goal. Increases above 50% in one step are blocked. Undoable with undo_action.

ParameterTypeDescription
account_idOptionalstring—
line_item_idRequiredstring—
nameOptionalstring—
objectiveOptionalAPP_ENGAGEMENTS | APP_INSTALLS | REACH | FOLLOWERS | ENGAGEMENTS | VIDEO_VIEWS | PREROLL_VIEWS | WEBSITE_CLICKS—
goalOptionalstring—
placementsOptionalarray<string>—
product_typeOptionalstring—
bid_strategyOptionalAUTO | MAX | TARGET—
bid_amountOptionalnumberaccount currency
daily_budgetOptionalnumberaccount currency
total_budgetOptionalnumberaccount currency
start_timeOptionalstringISO 8601 UTC
end_timeOptionalstringISO 8601 UTC
advertiser_domainOptionalstring—
categoriesOptionalarray<string>—
primary_web_event_tagOptionalstring—
android_app_store_identifierOptionalstring—
ios_app_store_identifierOptionalstring—
audience_expansionOptionalstring—
pay_byOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

x_status

쓰기Irreversible2 credits

Pause, activate or delete an X Ads campaign or ad group. Pause and activate are undoable; delete can't be undone, so confirm with the user first.

ParameterTypeDescription
account_idOptionalstring—
levelRequiredcampaign | line_item—
idRequiredstring—
statusRequiredpause | activate | delete—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_x_targeting

쓰기2 credits

Add or remove X Ads targeting on an ad group: location, interest, keyword, age, gender, platform, custom audience and more. Find values with x_targeting_search.

ParameterTypeDescription
account_idOptionalstring—
actionRequiredadd | remove—
line_item_idOptionalstring—
targeting_typeOptionalstring—
targeting_valueOptionalstring—
operator_typeOptionalEQ | NE | GTE | LT—
targeting_criterion_idOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_x_tweet

쓰기2 credits

Create an X ad post: ad-only by default, not shown on the timeline. Media must already be in the media library. Use its id in promote_x_tweets. Can't be undone.

ParameterTypeDescription
account_idOptionalstring—
textOptionalstring—
media_keysOptionalarray<string>—
card_uriOptionalstring—
as_user_idOptionalstring—
nameOptionalstring—
organicOptionalbooleantrue publishes to the timeline; default is an ad-only post
video_titleOptionalstring—
video_descriptionOptionalstring—
video_ctaOptionalstring—
video_cta_valueOptionalstring—
conversation_settingsOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

promote_x_tweets

쓰기2 credits

Promote X posts in an ad group (up to 50) or remove a promoted post.

ParameterTypeDescription
account_idOptionalstring—
actionOptionaladd | remove—
line_item_idOptionalstring—
tweet_idsOptionalarray<string>—
promoted_tweet_idOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_x_custom_audience

쓰기Irreversible2 credits

Create, update or delete X custom audiences and add or remove users by email. Emails are hashed before storing or sending; delete can't be undone.

ParameterTypeDescription
account_idOptionalstring—
actionRequiredcreate | update | delete | add_users | remove_users—
audience_idOptionalstring—
nameOptionalstring—
descriptionOptionalstring—
emailsOptionalarray<string>plain or SHA-256; hashed before storing or sending

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.