Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Creates a draft post in an X Ads account for review before publishing
| App | X Ads |
| Operation ID | x_ads_create_draft_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 to create the draft post in. |
text | string | No | - | The draft’s text. Required unless media is attached. |
media_urls | string or array of string | No | - | Media to upload and attach (list or comma-separated). Up to 4 images, or 1 GIF, or 1 video. Accepts direct URLs, Google Drive share links with sharing set to ‘Anyone with the link’, or files uploaded through Markifact. Use this OR media_keys. |
media_keys | string or array of string | No | - | Already-uploaded media keys to attach, e.g. from x_ads_upload_media. Up to 4 images, or 1 GIF, or 1 video. |
card_uri | string | No | - | Card to attach, from x_ads_create_card (card://…). A card already carries its own image or video, so do not also pass media_urls or media_keys: X accepts a post with both but then refuses to promote it. |
nullcast | boolean | No | True | true (default) marks the draft as Promoted-only when it is published. |
name | string | No | - | Internal name for the draft, up to 80 characters. |
as_user_id | string | No | - | User id to draft on behalf of. Defaults to the connected user; only set this when drafting for another handle you have access to. |
Dict
Returns the created draft post with full details including its id.
Fields: dynamic (depend on the inputs)