# x_ads_create_ad_post

> Compose a promoted-only ("nullcasted") post to use as an ad creative. A write tool that previews before it changes anything, one of 26 X Ads tools…

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [X Ads](https://www.getmcpads.com/docs/sources/x-ads)

Compose a promoted-only ("nullcasted") post to use as an ad creative. The post never appears on the author's profile or followers' timelines and spends nothing by itself ; attach it to a line item with promote_post. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.

> **Warning** This tool changes the account. It is absent from the tool list on the Free plan, and it previews by default: without `confirm: true` it describes the change and applies nothing.

|  |  |
| --- | --- |
| Source | [X Ads](https://www.getmcpads.com/docs/sources/x-ads) |
| Kind | Write |
| Discovery | Reachable through `search_tools` and `run_tool` |
| Account parameter | `account_id` |
| Endpoint | https://mcp.getmcpads.com/x-ads/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `account_id` | string | Required | X Ads account ID selected in Sources. |
| `as_user_id` | string | Required | User ID to post on behalf of (must be a promotable user of the account, e.g. the account's own ha... |
| `card_uri` | string | Optional | Card URI to attach (e.g. a website card). |
| `conversation_settings` | string | Optional | Who can reply to the post (default EVERYONE). One of: `EVERYONE`, `FOLLOWING`, `MENTIONED_USERS`. |
| `media_keys` | string | Optional | Comma-separated media keys of pre-uploaded media to attach (required unless text is provided). |
| `text` | string | Optional | Post text (required unless media_keys is provided). |
| `trim_user` | boolean | Optional | Return only the author's user ID instead of the full user object in the response (default false). |
| `tweet_mode` | string | Optional | Response rendering mode (default compat). One of: `compat`, `extended`. |
| `video_cta` | string | Optional | Call-to-action button on an attached video; set the target URL with video_cta_value. One of: `VISIT_SITE`, `WATCH_NOW`. |
| `video_cta_value` | string | Optional | Destination URL for the video_cta button; required when video_cta is set. |
| `video_description` | string | Optional | Description shown under an attached video (1-200 characters). |
| `video_title` | string | Optional | Title shown under an attached video (1-70 characters). |
| `confirm` | boolean | Optional | False previews only; true applies this exact change after explicit human confirmation. Default: `false`. |

## Calling it

Through run_tool, since it is not announced

```json
{
  "name": "run_tool",
  "arguments": {
    "name": "x_ads_create_ad_post",
    "args": {
      "account_id": "<string>",
      "as_user_id": "<string>"
    }
  }
}
```

- [X Ads metrics](https://www.getmcpads.com/docs/sources/x-ads/metrics): What you can ask for.
- [X Ads dimensions](https://www.getmcpads.com/docs/sources/x-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_create_ad_post
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.