Inputs
SelectItem
Output
Type:List[Dict]
Returns the created promoted tweet records.
Fields: dynamic (depend on the inputs)Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Promotes posts that already exist in an X Ads ad group, up to 50 at once, creating the ads (promoted tweets)
| App | X Ads |
| Operation ID | x_ads_create_ad_from_post |
| Type | Action |
| Connection | x_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| Requires approval | Yes (write operation) |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
account | DynamicAccount | Yes | - | Select the X Ads account that owns the ad group. |
ad_group_id | string or SelectItem | Yes | - | Ad group (line item) to promote the posts in. |
tweet_ids | string or array of string | Yes | - | IDs of the posts to promote (list or comma-separated string, up to 50). Use an organic post’s ID from x_ads_list_posts, or a Promoted-only post created by x_ads_create_post or by one of the format ad nodes with post_only enabled. X rejects posts that do not fit the ad group’s objective; notably, WEBSITE_CLICKS ad groups only accept posts containing a website link or card. Take the IDs from the id_str or tweet_id field, never a numeric id: X ids are 64-bit and any tool that stores them as a number rounds them into a post that does not exist. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | The value of the selectable item. |
label | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |
List[Dict]
Returns the created promoted tweet records.
Fields: dynamic (depend on the inputs)