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://…). |
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. |