Create Text Ad - Markifact

Creates a text-only Promoted-only post in an X Ads account and promotes it in an ad group, single or many at once. X ads have no status of their own, so keep the ad group or campaign paused until you are ready to spend. Enable post_only to build the creative without promoting it.


App	X Ads
Operation ID	`x_ads_create_text_ad`
Type	Action
Connection	`x_ads` (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`account`	DynamicAccount	Yes	-	Select the X Ads account to create the ad in.
`update_type`	string or SelectableOption	Yes	-	Choose whether to create a single ad or multiple at once. Options: single or bulk.
`ad_group_id`	string or SelectItem	No	-	Ad group (line item) to run the ad in. Required unless post_only is enabled. Keep the ad group or campaign paused until you are ready, since X ads have no status of their own and go live with their ad group.
`ad_name`	string	No	-	Internal name for the post, up to 80 characters.
`text`	string	No	-	The post’s text, up to 280 characters. Links in the text render as links; for a headline and image use x_ads_create_image_ad instead.
`conversation_settings`	enum (`EVERYONE`, `FOLLOWING`, `MENTIONED_USERS`)	No	-	Who can reply: EVERYONE (default), FOLLOWING, or MENTIONED_USERS.
`post_only`	boolean	No	`False`	Create the Promoted-only post without promoting it, so it can be reused across ad groups with x_ads_create_ad_from_post.
`return_detailed_results`	boolean	No	`False`	Include the full post and ad objects in the output.
`structured_data`	array (also accepts a comma-separated string)	No	-	Use only when update_type is bulk. Columns: text (required), plus optional ad_group_id, ad_name, and conversation_settings. Up to 100 rows.

SelectItem

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.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: Dict Returns the created post id, card id when one was built, and ad id. Bulk runs return one entry per row. Fields: dynamic (depend on the inputs)