Update an X Ads line item
Update a line item's bid, budget, name, schedule, placements, goal, pacing, audience expansion (set audience_expansion=EXPANDED to turn on Optimized Targeting). 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 and line item id.
Inputs
- Account ID
- X Ads account ID selected in SourcesRequired · account_id
- Line item ID
- Line item ID belonging to the selected X Ads accountRequired · line_item_id
- Advertiser domain
- New website domain of the advertiser (no protocol); required when placements includes PUBLISHER_N..Optional · advertiser_domain
- Android app store identifier
- New Google Play package name of the promoted app, e.g. com.example.appOptional · android_app_store_identifier
- Audience expansion
- New audience expansion level; EXPANDED turns on what Ads Manager calls Optimized Targeting (off b.. (BROAD, DEFINED or EXPANDED)Optional · audience_expansion
- Bid amount local micro
- New bid in micros of the account currency; only with bid_strategy MAX or TARGETOptional · bid_amount_local_micro
- Bid strategy
- New bidding strategy (AUTO, MAX or TARGET)Optional · bid_strategy
- Categories
- New comma-separated IAB content category IDs, e.g. IAB3-1,IAB19 (see list_iab_categories)Optional · categories
- Daily budget amount local micro
- New line item daily budget in microsOptional · daily_budget_amount_local_micro
- Duration in days
- New frequency_cap window (1, 7 or 30 days); set together with frequency_capOptional · duration_in_days
- End time
- New end time (ISO 8601)Optional · end_time
- Entity status
- Set PAUSED to pause this ad group (the only pause path)Optional · entity_status
- Frequency cap
- New maximum times an ad can be delivered to a user within duration_in_daysOptional · frequency_cap
- Goal
- New optimization goal (e.g. ENGAGEMENT, LINK_CLICKS, SITE_VISITS, WEBSITE_CONVERSIONS, FOLLOWERS,..Optional · goal
- Ios app store identifier
- New numeric Apple App Store ID of the promoted app, e.g. 333903271Optional · ios_app_store_identifier
- Name
- New line item name (1-255 characters)Optional · name
- Pay by
- New unit to pay byOptional · pay_by
- Placements
- New comma-separated placements, e.g. ALL_ON_TWITTER or TWITTER_TIMELINE,TWITTER_PROFILEOptional · placements
- Primary web event tag
- New website conversion tag (pixel) id; see list_web_event_tagsOptional · primary_web_event_tag
- Standard delivery
- True paces spend evenly through the day; false spends as fast as possible (accelerated delivery, ..Optional · standard_delivery
- Start time
- New start time (ISO 8601)Optional · start_time
- Total budget amount local micro
- New line item total budget in microsOptional · 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 line itemX 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
- Compare all 11
Connect your agent to 2,400+ tools for free
Sign in with Google or GitHub. No card required.