API Reference

x-ads / API Reference

x_ads_create_line_item

X (Twitter) Ads tool, proxied to X's own Ads MCP gateway. Create a line item (ad group) under an X campaign. Created PAUSED by X. This is where the money is set: daily_budget_micro is in micro-units, so $50.00 is 50000000. placements is comma-separated, e.g. "ALL_ON_TWITTER" or "PUBLISHER_NETWORK". start_time is ISO 8601.

This is a read-only tool: it returns x ads create line item for your x-ads account. It changes nothing.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

X ads create line item in my x-ads account for [campaign id], [objective], [placements].

It takes 6 required and 4 optional parameters.

Parameters

ParameterTypeRequiredDescription
account_idstringYesAccount Id
campaign_idstringYesCampaign Id
objectivestringYesObjective
placementsstringYesPlacements
daily_budget_microintegerYesDaily Budget Micro
start_timestringYesStart Time
namestringNoName
bid_amount_microintegerNoBid Amount Micro
end_timestringNoEnd Time
product_typestringNoProduct Type

Related x-ads tools

Before you can call it

This tool needs a connected x-ads account. The x-ads connect guide covers how to authorize it and what it unlocks, and the quickstart gets a client talking to the server in about five minutes.

Start free — 30 tool calls a month

No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.