Create an X Ads line item
Create a line item (ad group) under a campaign. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id, campaign id, daily budget amount local micro and more.
Inputs
- Account ID
- X Ads account ID selected in SourcesRequired · account_id
- Campaign ID
- Campaign to create the line item underRequired · campaign_id
- Daily budget amount local micro
- Daily budget for this line item (ad group) in micros of the account currency (e.g. 50000000 = $50..Required · daily_budget_amount_local_micro
- Objective
- Campaign objective for this line itemRequired · objective
- Placements
- Comma-separated placements, e.g. ALL_ON_TWITTER or TWITTER_TIMELINE,TWITTER_PROFILERequired · placements
- Start time
- Line item start time (ISO 8601, e.g. 2026-08-01T00:00:00Z)Required · start_time
- Advertiser domain
- Website domain of the advertiser (no protocol), e.g. x.com; required when placements includes PUB..Optional · advertiser_domain
- Android app store identifier
- Google Play package name of the promoted app, e.g. com.example.app; for APP_INSTALLS / APP_ENGAGE..Optional · android_app_store_identifier
- Audience expansion
- Audience expansion level (BROAD, DEFINED or EXPANDED)Optional · audience_expansion
- Bid amount local micro
- Bid in micros of the account currency; only with bid_strategy MAX or TARGETOptional · bid_amount_local_micro
- Bid strategy
- Bidding strategy (AUTO, MAX or TARGET)Optional · bid_strategy
- Categories
- Comma-separated IAB content category IDs for the advertiser, e.g. IAB3-1,IAB19 (see list_iab_cate..Optional · categories
- Duration in days
- Window over which frequency_cap applies (1, 7 or 30 days); set together with frequency_capOptional · duration_in_days
- End time
- Line item end time (ISO 8601)Optional · end_time
- Frequency cap
- Maximum times an ad can be delivered to a user within duration_in_days; only for REACH, ENGAGEMEN..Optional · frequency_cap
- Goal
- Optimization goal (e.g. ENGAGEMENT, LINK_CLICKS, SITE_VISITS, WEBSITE_CONVERSIONS, FOLLOWERS, APP..Optional · goal
- Ios app store identifier
- Numeric Apple App Store ID of the promoted app, e.g. 333903271; for APP_INSTALLS / APP_ENGAGEMENT..Optional · ios_app_store_identifier
- Name
- Line item name (1-255 characters)Optional · name
- Pay by
- Unit to pay byOptional · pay_by
- Primary web event tag
- Website conversion tag (pixel) id, required when goal=WEBSITE_CONVERSIONS; see list_web_event_tagsOptional · primary_web_event_tag
- Product type
- Promoted product type (PROMOTED_TWEETS, PROMOTED_ACCOUNT or MEDIA)Optional · product_type
- Standard delivery
- True (default) paces spend evenly through the day; false spends as fast as possible (accelerated ..Optional · standard_delivery
- Total budget amount local micro
- Line item total budget in micros of the account currencyOptional · total_budget_amount_local_micro
- Confirm
- False previews only; true applies this exact change after explicit human confirmationOptional · confirm
- Workspace ID
- Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id
- Reason
- Why, in the person's words or from the evidence (e.g. CPA twice the target for 7 days)Optional · reason
Pricing
- Price
- Free preview, $0.05 per applied change
- Billing
- The provider’s price, with no markup. Billed for measured usage.
Call
Your agent reads the schema and the price with inspect_tool before it runs the tool.
- MCP call
- cURL command
- TypeScript
- Tool ID
Alternatives
- Activate an X Ads campaignX Ads$0.05/change
- Activate an X Ads line itemX Ads$0.05/change
- Create an X ad postX Ads$0.05/change
- Create an X Ads campaignX Ads$0.05/change
- Create an X Ads web event tagX Ads$0.05/change
- Delete an X Ads web event tagX Ads$0.05/change
- Promote an X Ads postX Ads$0.05/change
- Update an X Ads campaignX Ads$0.05/change
- Compare all 11
Connect your agent to 2,400+ tools for free
Sign in with Google or GitHub. No card required.