> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-a8d4e7d2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# X Ads MCP API Reference

> Reference mapping each X Ads MCP tool to its backing Ads API endpoint.

## API Reference Guide

The 74 tools are backed by the following Ads API endpoints (74 routes, served through the x-api gateway at major version `/12`):

| Method | Path                                                                                                                                                                                           | Used by tool                    |
| :----- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------ |
| GET    | [`/12/accounts`](/x-ads-api/campaign-management/reference#get-accounts)                                                                                                                        | `list_ads_accounts`             |
| GET    | [`/12/accounts/:account_id/campaigns`](/x-ads-api/campaign-management/reference#get-accounts/account_id/campaigns)                                                                             | `list_campaigns`                |
| GET    | [`/12/accounts/:account_id/campaigns/:campaign_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/campaigns/campaign_id)                                                    | `get_campaign`                  |
| GET    | [`/12/accounts/:account_id/line_items`](/x-ads-api/campaign-management/reference#get-accounts/account_id/line_items)                                                                           | `list_line_items`               |
| GET    | [`/12/accounts/:account_id/line_items/:line_item_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/line_items/line_item_id)                                                | `get_line_item`                 |
| GET    | [`/12/line_items/placements`](/x-ads-api/campaign-management/reference#get-line_items/placements)                                                                                              | `list_line_item_placements`     |
| GET    | [`/12/accounts/:account_id/funding_instruments`](/x-ads-api/campaign-management/reference#get-accounts/account_id/funding_instruments)                                                         | `list_funding_instruments`      |
| GET    | [`/12/accounts/:account_id/funding_instruments/:funding_instrument_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/funding_instruments/funding_instrument_id)            | `get_funding_instrument`        |
| GET    | [`/12/accounts/:account_id/promoted_tweets`](/x-ads-api/campaign-management/reference#get-accounts/account_id/promoted_tweets)                                                                 | `list_promoted_posts`           |
| GET    | [`/12/accounts/:account_id/promoted_tweets/:promoted_tweet_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/promoted_tweets/promoted_tweet_id)                            | `get_promoted_post`             |
| GET    | [`/12/accounts/:account_id/tweets`](/x-ads-api/creatives/reference#get-accounts/account_id/tweets)                                                                                             | `list_account_posts`            |
| GET    | [`/12/stats/accounts/:account_id/active_entities`](/x-ads-api/analytics#get-stats/accounts/account_id/active_entities)                                                                         | `get_active_entities`           |
| GET    | [`/12/stats/accounts/:account_id`](/x-ads-api/analytics#get-stats/accounts/account_id)                                                                                                         | `get_account_stats`             |
| GET    | [`/12/stats/accounts/:account_id/reach/campaigns`](/x-ads-api/analytics#get-stats/accounts/account_id/reach/campaigns)                                                                         | `get_campaign_reach`            |
| GET    | [`/12/targeting_criteria/interests`](/x-ads-api/campaign-management/reference#get-targeting_criteria/interests)                                                                                | `search_targeting_interests`    |
| GET    | [`/12/targeting_criteria/locations`](/x-ads-api/campaign-management/reference#get-targeting_criteria/locations)                                                                                | `search_targeting_locations`    |
| GET    | [`/12/accounts/:account_id/targeting_criteria`](/x-ads-api/campaign-management/reference#get-accounts/account_id/targeting_criteria)                                                           | `list_targeting_criteria`       |
| GET    | [`/12/accounts/:account_id/targeting_criteria/:targeting_criterion_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/targeting_criteria/targeting_criterion_id)            | `get_targeting_criterion`       |
| POST   | [`/12/accounts/:account_id/audience_estimate`](/x-ads-api/campaign-management/reference#audience-estimate)                                                                                     | `estimate_audience`             |
| GET    | [`/12/accounts/:account_id/custom_audiences`](/x-ads-api/audiences/reference#get-accounts/account_id/custom_audiences)                                                                         | `list_custom_audiences`         |
| GET    | [`/12/accounts/:account_id/custom_audiences/:custom_audience_id`](/x-ads-api/audiences/reference#get-accounts/account_id/custom_audiences/custom_audience_id)                                  | `get_custom_audience`           |
| POST   | [`/12/accounts/:account_id/custom_audiences`](/x-ads-api/audiences/reference#post-accounts/account_id/custom_audiences)                                                                        | `create_custom_audience`        |
| PUT    | [`/12/accounts/:account_id/custom_audiences/:custom_audience_id`](/x-ads-api/audiences/reference#put-accounts/account_id/custom_audiences/custom_audience_id)                                  | `update_custom_audience`        |
| DELETE | [`/12/accounts/:account_id/custom_audiences/:custom_audience_id`](/x-ads-api/audiences/reference#delete-accounts/account_id/custom_audiences/custom_audience_id)                               | `delete_custom_audience`        |
| GET    | [`/12/accounts/:account_id/custom_audiences/:custom_audience_id/targeted`](/x-ads-api/audiences/reference#get-accounts/account_id/custom_audiences/custom_audience_id/targeted)                | `list_custom_audience_targeted` |
| GET    | [`/12/accounts/:account_id/do_not_reach_lists`](/x-ads-api/audiences/reference#get-accounts/account_id/do_not_reach_lists)                                                                     | `list_do_not_reach_lists`       |
| POST   | [`/12/accounts/:account_id/do_not_reach_lists`](/x-ads-api/audiences/reference#post-accounts/account_id/do_not_reach_lists)                                                                    | `create_do_not_reach_list`      |
| DELETE | [`/12/accounts/:account_id/do_not_reach_lists/:do_not_reach_list_id`](/x-ads-api/audiences/reference#delete-accounts/account_id/do_not_reach_lists/do_not_reach_list_id)                       | `delete_do_not_reach_list`      |
| POST   | [`/12/batch/accounts/:account_id/do_not_reach_lists/:do_not_reach_list_id/users`](/x-ads-api/audiences/reference#post-batch/accounts/account_id/do_not_reach_lists/do_not_reach_list_id/users) | `batch_do_not_reach_list_users` |
| GET    | `/12/accounts/:account_id/cards`                                                                                                                                                               | `list_cards`                    |
| GET    | `/12/accounts/:account_id/cards/:card_id`                                                                                                                                                      | `get_card`                      |
| POST   | [`/12/accounts/:account_id/cards`](/x-ads-api/creatives/reference#post-accounts/account_id/cards)                                                                                              | `create_card`                   |
| DELETE | `/12/accounts/:account_id/cards/:card_id`                                                                                                                                                      | `delete_card`                   |
| GET    | [`/12/accounts/:account_id/media_library`](/x-ads-api/creatives/reference#get-accounts/account_id/media_library)                                                                               | `list_media_library`            |
| GET    | `/12/accounts/:account_id/media_library/:media_key`                                                                                                                                            | `get_media_library_item`        |
| POST   | `/12/accounts/:account_id/media_library`                                                                                                                                                       | `create_media_library_item`     |
| PUT    | `/12/accounts/:account_id/media_library/:media_key`                                                                                                                                            | `update_media_library_item`     |
| DELETE | `/12/accounts/:account_id/media_library/:media_key`                                                                                                                                            | `delete_media_library_item`     |
| GET    | [`/12/accounts/:account_id/account_media`](/x-ads-api/creatives/reference#get-accounts/account_id/account_media)                                                                               | `list_account_media`            |
| GET    | `/12/accounts/:account_id/account_media/:account_media_id`                                                                                                                                     | `get_account_media`             |
| DELETE | `/12/accounts/:account_id/account_media/:account_media_id`                                                                                                                                     | `delete_account_media`          |
| GET    | [`/12/accounts/:account_id/media_creatives`](/x-ads-api/campaign-management/reference#get-accounts/account_id/media_creatives)                                                                 | `list_media_creatives`          |
| GET    | [`/12/accounts/:account_id/media_creatives/:media_creative_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/media_creatives/media_creative_id)                            | `get_media_creative`            |
| POST   | [`/12/accounts/:account_id/media_creatives`](/x-ads-api/campaign-management/reference#post-accounts/account_id/media_creatives)                                                                | `create_media_creative`         |
| DELETE | [`/12/accounts/:account_id/media_creatives/:media_creative_id`](/x-ads-api/campaign-management/reference#delete-accounts/account_id/media_creatives/media_creative_id)                         | `delete_media_creative`         |
| GET    | [`/12/accounts/:account_id/tweet_previews`](/x-ads-api/creatives/reference#get-accounts/account_id/tweet_previews)                                                                             | `list_post_previews`            |
| GET    | `/12/accounts/:account_id/web_event_tags`                                                                                                                                                      | `list_web_event_tags`           |
| GET    | `/12/accounts/:account_id/web_event_tags/:web_event_tag_id`                                                                                                                                    | `get_web_event_tag`             |
| POST   | `/12/accounts/:account_id/web_event_tags`                                                                                                                                                      | `create_web_event_tag`          |
| PUT    | `/12/accounts/:account_id/web_event_tags/:web_event_tag_id`                                                                                                                                    | `update_web_event_tag`          |
| DELETE | `/12/accounts/:account_id/web_event_tags/:web_event_tag_id`                                                                                                                                    | `delete_web_event_tag`          |
| GET    | [`/12/accounts/:account_id/app_event_tags`](/x-ads-api/measurement/mobile-conversions#get-accounts/account_id/app_event_tags)                                                                  | `list_app_event_tags`           |
| GET    | [`/12/accounts/:account_id/app_event_tags/:app_event_tag_id`](/x-ads-api/measurement/mobile-conversions#get-accounts/account_id/app_event_tags/app_event_tag_id)                               | `get_app_event_tag`             |
| POST   | `/12/accounts/:account_id/app_event_tags`                                                                                                                                                      | `create_app_event_tag`          |
| DELETE | `/12/accounts/:account_id/app_event_tags/:app_event_tag_id`                                                                                                                                    | `delete_app_event_tag`          |
| GET    | [`/12/accounts/:account_id/tracking_tags`](/x-ads-api/campaign-management/reference#get-accounts/account_id/tracking_tags)                                                                     | `list_tracking_tags`            |
| GET    | [`/12/accounts/:account_id/tracking_tags/:tracking_tag_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/tracking_tags/tracking_tag_id)                                    | `get_tracking_tag`              |
| POST   | [`/12/accounts/:account_id/tracking_tags`](/x-ads-api/campaign-management/reference#post-accounts/account_id/tracking_tags)                                                                    | `create_tracking_tag`           |
| PUT    | [`/12/accounts/:account_id/tracking_tags/:tracking_tag_id`](/x-ads-api/campaign-management/reference#put-accounts/account_id/tracking_tags/tracking_tag_id)                                    | `update_tracking_tag`           |
| DELETE | [`/12/accounts/:account_id/tracking_tags/:tracking_tag_id`](/x-ads-api/campaign-management/reference#delete-accounts/account_id/tracking_tags/tracking_tag_id)                                 | `delete_tracking_tag`           |
| GET    | `/12/accounts/:account_id/app_lists`                                                                                                                                                           | `list_app_lists`                |
| GET    | `/12/accounts/:account_id/app_lists/:app_list_id`                                                                                                                                              | `get_app_list`                  |
| POST   | `/12/accounts/:account_id/app_lists`                                                                                                                                                           | `create_app_list`               |
| DELETE | `/12/accounts/:account_id/app_lists/:app_list_id`                                                                                                                                              | `delete_app_list`               |
| POST   | [`/12/accounts/:account_id/campaigns`](/x-ads-api/campaign-management/reference#post-accounts/account_id/campaigns)                                                                            | `create_campaign`               |
| PUT    | [`/12/accounts/:account_id/campaigns/:campaign_id`](/x-ads-api/campaign-management/reference#put-accounts/account_id/campaigns/campaign_id)                                                    | `update_campaign`               |
| PUT    | `/12/accounts/:account_id/campaigns/:campaign_id/activate`                                                                                                                                     | `activate_campaign`             |
| POST   | [`/12/accounts/:account_id/line_items`](/x-ads-api/campaign-management/reference#post-accounts/account_id/line_items)                                                                          | `create_line_item`              |
| PUT    | [`/12/accounts/:account_id/line_items/:line_item_id`](/x-ads-api/campaign-management/reference#put-accounts/account_id/line_items/line_item_id)                                                | `update_line_item`              |
| PUT    | `/12/accounts/:account_id/line_items/:line_item_id/activate`                                                                                                                                   | `activate_line_item`            |
| POST   | [`/12/accounts/:account_id/targeting_criteria`](/x-ads-api/campaign-management/reference#post-accounts/account_id/targeting_criteria)                                                          | `add_targeting_criterion`       |
| DELETE | [`/12/accounts/:account_id/targeting_criteria/:targeting_criterion_id`](/x-ads-api/campaign-management/reference#delete-accounts/account_id/targeting_criteria/targeting_criterion_id)         | `remove_targeting`              |
| POST   | [`/12/accounts/:account_id/tweet`](/x-ads-api/creatives/reference#post-accounts/account_id/tweet)                                                                                              | `create_ad_post`                |
| POST   | [`/12/accounts/:account_id/promoted_tweets`](/x-ads-api/campaign-management/reference#post-accounts/account_id/promoted_tweets)                                                                | `promote_post`                  |
