> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whathead.com/llms.txt
> Use this file to discover all available pages before exploring further.

# X Ads

> Build and publish X (Twitter) Ads campaigns, line items and promoted posts in Whathead, report in Google Sheets, and manage X Ads from Claude or ChatGPT.

Whathead connects to X Ads (formerly Twitter Ads) with your X login. You can build campaigns, line items and promoted posts on the visual canvas, load live X campaigns to edit them, bulk edit, upload media, report on X in Google Sheets, and let an AI assistant read and change X Ads through the Whathead MCP server.

## Key facts

| | X Ads in Whathead |
| - | - |
| Connect | Sign in with X (OAuth), then choose ad accounts, pixels, promotable users and apps |
| Visual campaign builder | Yes: campaign → line item → promoted post |
| Load existing campaigns | Yes |
| Bulk edit | Yes (campaign status, budget, start and end date) |
| Media upload | Yes, including X post upload |
| Cross-platform transfer | Not yet (transfer works between Meta, TikTok and Snapchat) |
| AI assistant (MCP) | `x_ads_native_action` gateway, read and write |
| Reporting | Google Sheets add-on and Looker Studio connector source (beta) |
| Anomaly Engine | Supported (early access) |

## What you can do

* **Build and publish.** Add X campaigns, line items and promoted posts to the canvas next to your other platforms, then publish them to the ad account you choose.
* **Edit live campaigns.** Load existing X campaigns, line items and promoted posts into the builder, change them, and publish only what changed.
* **Bulk edit.** Change status, budget and flight dates across many X campaigns at once.
* **Upload creative.** Upload images and videos to X, or create X posts to promote.
* **Report.** Pull X Ads metrics into Google Sheets with scheduled refresh. X is a beta source in the [Google Sheets add-on](https://docs.whathead.com/reporting/google-sheets-add-on.md).
* **Work from chat.** Ask Claude or ChatGPT to list campaigns, check line items or prepare changes. Writes are previewed and need your confirmation. See the [MCP tool catalog](https://docs.whathead.com/ai-assistant/tool-catalog.md).

## Ask your AI assistant

> [!TIP]
>
> Try: *"List my active X campaigns and their daily budgets"*, or *"Pause the X line items in this campaign that spent over \$200 yesterday, but show me the preview first."*

## Not supported yet

* Cross-platform transfer to or from X.
* An in-app X reporting dashboard. Use the Sheets add-on or MCP for X reporting.

## Related

> [card] [Connect X Ads](https://docs.whathead.com/platforms/x/connection-setup.md)
>
> Sign in with X and choose the assets Whathead can use.

> [card] [Platform capability matrix](https://docs.whathead.com/platforms/capability-matrix.md)
>
> Compare what each platform supports in Whathead.

> [card] [X Ads operations guide](https://blog.whathead.com/x-ads-operations-guide)
>
> Posts, cards, media and campaign QA on X (blog).

> [card] [Whathead MCP server](https://www.whathead.com/mcp-server)
>
> Manage X Ads and other platforms from Claude or ChatGPT.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.