Create an X ad post
Compose a promoted-only ("nullcasted") post to use as an ad creative. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and as user id.
Inputs
- Account ID
- X Ads account ID selected in SourcesRequired · account_id
- As user ID
- User ID to post on behalf of (must be a promotable user of the account, e.g. the account's own ha..Required · as_user_id
- Card uri
- Card URI to attach (e.g. a website card)Optional · card_uri
- Conversation settings
- Who can reply to the post (default EVERYONE) (EVERYONE, FOLLOWING or MENTIONED_USERS)Optional · conversation_settings
- Media keys
- Comma-separated media keys of pre-uploaded media to attach (required unless text is provided)Optional · media_keys
- Text
- Post text (required unless media_keys is provided)Optional · text
- Trim user
- Return only the author's user ID instead of the full user object in the response (default false)Optional · trim_user
- Tweet mode
- Response rendering mode (default compat) (compat or extended)Optional · tweet_mode
- Video cta
- Call-to-action button on an attached video; set the target URL with video_cta_value (VISIT_SITE or WATCH_NOW)Optional · video_cta
- Video cta value
- Destination URL for the video_cta button; required when video_cta is setOptional · video_cta_value
- Video description
- Description shown under an attached video (1-200 characters)Optional · video_description
- Video title
- Title shown under an attached video (1-70 characters)Optional · video_title
- Confirm
- False previews only; true applies this exact change after explicit human confirmationOptional · confirm
- Workspace ID
- Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id
- Reason
- Why, in the person's words or from the evidence (e.g. CPA twice the target for 7 days)Optional · reason
Pricing
- Price
- Free preview, $0.05 per applied change
- Billing
- The provider’s price, with no markup. Billed for measured usage.
Call
Your agent reads the schema and the price with inspect_tool before it runs the tool.
- MCP call
- cURL command
- TypeScript
- Tool ID
Alternatives
- Activate an X Ads campaignX Ads$0.05/change
- Activate an X Ads line itemX Ads$0.05/change
- Create an X Ads campaignX Ads$0.05/change
- Create an X Ads line itemX Ads$0.05/change
- Create an X Ads web event tagX Ads$0.05/change
- Delete an X Ads web event tagX Ads$0.05/change
- Promote an X Ads postX Ads$0.05/change
- Update an X Ads campaignX Ads$0.05/change
- Compare all 11
Connect your agent to 2,400+ tools for free
Sign in with Google or GitHub. No card required.