# Markifact: Documentation Operations X Ads

## X Ads

- [Custom X Ads App](https://docs.markifact.com/nodes/x_ads/x_ads_custom_app.md): Connect X Ads through your own X app (white-label) by pasting your API key, API key secret, access token, and access token secret.
- [Get Report](https://docs.markifact.com/nodes/x_ads/x_ads_get_report.md): Retrieves X (Twitter) Ads data with customizable metrics, dimensions, filters, date ranges, and sorting options
- [List Report Fields](https://docs.markifact.com/nodes/x_ads/x_ads_list_report_fields.md): Search and browse available X (Twitter) Ads reporting metrics and dimensions before running reports
- [Select Accounts](https://docs.markifact.com/nodes/x_ads/x_ads_select_accounts.md): Select X (Twitter) Ads accounts once and reuse them across multiple x_ads_get_report nodes, with no repeated account selection
- [List Campaigns](https://docs.markifact.com/nodes/x_ads/x_ads_list_campaigns.md): Lists campaigns in an X (Twitter) Ads account with full details
- [List Ad Groups](https://docs.markifact.com/nodes/x_ads/x_ads_list_ad_groups.md): Lists ad groups (line items) in an X (Twitter) Ads account with full details including objective, bidding, and placements
- [List Ads](https://docs.markifact.com/nodes/x_ads/x_ads_list_ads.md): Lists ads (promoted posts) in an X (Twitter) Ads account, optionally with each promoted post's full post object attached under a 'tweet' key
- [List Funding Instruments](https://docs.markifact.com/nodes/x_ads/x_ads_list_funding_instruments.md): Lists funding instruments (payment sources) in an X (Twitter) Ads account
- [Update Campaign Status](https://docs.markifact.com/nodes/x_ads/x_ads_update_campaign_status.md): Activates, pauses, or permanently deletes X (Twitter) Ads campaigns, one or many at once
- [Update Ad Group Status](https://docs.markifact.com/nodes/x_ads/x_ads_update_ad_group_status.md): Activates, pauses, or permanently deletes X (Twitter) Ads ad groups (line items), one or many at once
- [Update Ad Status](https://docs.markifact.com/nodes/x_ads/x_ads_update_ad_status.md): Permanently deletes X (Twitter) ads (promoted posts), one or many at once
- [Rename Campaign](https://docs.markifact.com/nodes/x_ads/x_ads_rename_campaign.md): Renames X (Twitter) Ads campaigns, one or many at once
- [Rename Ad Group](https://docs.markifact.com/nodes/x_ads/x_ads_rename_ad_group.md): Renames X (Twitter) Ads ad groups (line items), one or many at once
- [Update Campaign Budget](https://docs.markifact.com/nodes/x_ads/x_ads_update_campaign_budget.md): Updates the daily or total budget of X (Twitter) Ads campaigns, one or many at once
- [Update Ad Group Budget](https://docs.markifact.com/nodes/x_ads/x_ads_update_ad_group_budget.md): Updates the daily or total budget of X (Twitter) Ads ad groups (line items), one or many at once
- [Update Campaign](https://docs.markifact.com/nodes/x_ads/x_ads_update_campaign.md): Updates an X (Twitter) Ads campaign with a raw fields payload; only provided fields are changed
- [Update Ad Group](https://docs.markifact.com/nodes/x_ads/x_ads_update_ad_group.md): Updates an X (Twitter) Ads ad group (line item) with a raw fields payload; only provided fields are changed
- [Create Campaign](https://docs.markifact.com/nodes/x_ads/x_ads_create_campaign.md): Creates an X (Twitter) Ads campaign under a funding instrument, with budgets entered in the account currency
- [Create Ad Group](https://docs.markifact.com/nodes/x_ads/x_ads_create_ad_group.md): Creates an X (Twitter) Ads ad group (line item) in a campaign: objective, placements, schedule, bidding strategy and goal, budgets, frequency caps, and app identifiers
- [Upload Media](https://docs.markifact.com/nodes/x_ads/x_ads_upload_media.md): Uploads an image or video from a URL to X and registers it in the ads account's Media Library
- [Create Post](https://docs.markifact.com/nodes/x_ads/x_ads_create_post.md): Creates a post in an X Ads account, by default a Promoted-only (dark) post that never appears in followers' timelines
- [Create Ad From Post](https://docs.markifact.com/nodes/x_ads/x_ads_create_ad_from_post.md): Promotes posts that already exist in an X Ads ad group, up to 50 at once, creating the ads (promoted tweets)
- [Search Targeting](https://docs.markifact.com/nodes/x_ads/x_ads_search_targeting.md): Searches X Ads targeting values (locations, interests, events, conversation topics, app store categories, network operators, devices, platforms, languages, TV markets and shows) and returns their i...
- [Set Targeting](https://docs.markifact.com/nodes/x_ads/x_ads_set_targeting.md): Adds and removes targeting criteria on an X Ads ad group (keywords, locations, interests, demographics, followers, custom audiences and more) using X's batch endpoint
- [List Audiences](https://docs.markifact.com/nodes/x_ads/x_ads_list_audiences.md): Lists custom audiences in an X (Twitter) Ads account with full details including whether each is targetable
- [Create Audience](https://docs.markifact.com/nodes/x_ads/x_ads_create_audience.md): Creates an empty X (Twitter) Ads custom audience
- [Add Users To Audience](https://docs.markifact.com/nodes/x_ads/x_ads_add_users_to_audience.md): Adds users to an X (Twitter) Ads custom audience by email, phone number, device id, handle, X user id, or partner user id
- [Remove Users From Audience](https://docs.markifact.com/nodes/x_ads/x_ads_remove_users_from_audience.md): Removes users from an X (Twitter) Ads custom audience, hashing identifiers the same way they were added
- [Update Audience](https://docs.markifact.com/nodes/x_ads/x_ads_update_audience.md): Renames an X (Twitter) Ads custom audience or updates its description; X allows no other audience edits
- [Delete Audience](https://docs.markifact.com/nodes/x_ads/x_ads_delete_audience.md): Permanently deletes an X (Twitter) Ads custom audience
- [Create Card](https://docs.markifact.com/nodes/x_ads/x_ads_create_card.md): Creates an X Ads card (website or app, single media or carousel) from raw components matching the X API payload
- [List Cards](https://docs.markifact.com/nodes/x_ads/x_ads_list_cards.md): Lists cards in an X (Twitter) Ads account with their card_uri values, optionally filtered by card type
- [Create Follower Ad](https://docs.markifact.com/nodes/x_ads/x_ads_create_follower_ad.md): Promotes an X account in a FOLLOWERS ad group (product type PROMOTED_ACCOUNT), creating a follower ad
- [List Posts](https://docs.markifact.com/nodes/x_ads/x_ads_list_posts.md): Lists posts in an X (Twitter) Ads account: published, draft, or scheduled, and organic or Promoted-only
- [Get Post Previews](https://docs.markifact.com/nodes/x_ads/x_ads_get_post_previews.md): Returns rendered previews of X posts as they will appear when promoted, for published, draft, or scheduled posts
- [Get Account History](https://docs.markifact.com/nodes/x_ads/x_ads_get_account_history.md): Retrieves the change history of one X Ads entity (campaign, ad group, ad, targeting criteria, or promoted account), showing what changed and when
- [List Media](https://docs.markifact.com/nodes/x_ads/x_ads_list_media.md): Lists the media in an X Ads account Media Library with their media_key values, so existing images and videos can be reused in posts and cards
- [List Targeting](https://docs.markifact.com/nodes/x_ads/x_ads_list_targeting.md): Lists the targeting criteria on X Ads ad groups, including each criterion ID needed to remove it with x_ads_set_targeting
- [Get Keyword Insights](https://docs.markifact.com/nodes/x_ads/x_ads_get_keyword_insights.md): Returns X post volume for a set of keywords plus 30 related keyword suggestions, for planning keyword targeting
- [Get Account Details](https://docs.markifact.com/nodes/x_ads/x_ads_get_account_details.md): Returns an X Ads account with its settings, enabled features, the authenticated user's permission level on it, and the users promotable from it
- [Get Reach Report](https://docs.markifact.com/nodes/x_ads/x_ads_get_reach_report.md): Retrieves total audience reach and average frequency for X Ads campaigns or funding instruments
- [Get Targeting Suggestions](https://docs.markifact.com/nodes/x_ads/x_ads_get_targeting_suggestions.md): Returns X targeting suggestions seeded from keywords or user IDs: related keywords, or similar accounts whose followers can be targeted
- [List Tracking Tags](https://docs.markifact.com/nodes/x_ads/x_ads_list_tracking_tags.md): Lists third-party tracking tags on X Ads ad groups
- [Create Tracking Tag](https://docs.markifact.com/nodes/x_ads/x_ads_create_tracking_tag.md): Attaches a third-party impression tag or click tracker to an X Ads ad group
- [Update Tracking Tag](https://docs.markifact.com/nodes/x_ads/x_ads_update_tracking_tag.md): Updates the URL of an X Ads tracking tag
- [Delete Tracking Tag](https://docs.markifact.com/nodes/x_ads/x_ads_delete_tracking_tag.md): Permanently deletes an X Ads tracking tag
- [Delete Card](https://docs.markifact.com/nodes/x_ads/x_ads_delete_card.md): Permanently deletes an X Ads card
- [Create Draft Post](https://docs.markifact.com/nodes/x_ads/x_ads_create_draft_post.md): Creates a draft post in an X Ads account for review before publishing
- [Update Draft Post](https://docs.markifact.com/nodes/x_ads/x_ads_update_draft_post.md): Updates an X Ads draft post: its text, media, card, name, or Promoted-only flag
- [Delete Draft Post](https://docs.markifact.com/nodes/x_ads/x_ads_delete_draft_post.md): Permanently deletes an X Ads draft post
- [Preview Draft Post](https://docs.markifact.com/nodes/x_ads/x_ads_preview_draft_post.md): Sends a preview of an X Ads draft post to a user, who receives it in the X app on their device for review
- [Share Audience](https://docs.markifact.com/nodes/x_ads/x_ads_share_audience.md): Shares an X Ads custom audience with another ad account, read-only or read-write
- [Unshare Audience](https://docs.markifact.com/nodes/x_ads/x_ads_unshare_audience.md): Revokes another ad account's access to an X Ads custom audience
- [List Audience Permissions](https://docs.markifact.com/nodes/x_ads/x_ads_list_audience_permissions.md): Lists which ad accounts an X Ads custom audience is shared with, and each permission ID needed to revoke access
- [List Audience Usage](https://docs.markifact.com/nodes/x_ads/x_ads_list_audience_usage.md): Lists the ad groups and campaigns currently targeting an X Ads custom audience
- [List Do Not Reach Lists](https://docs.markifact.com/nodes/x_ads/x_ads_list_do_not_reach_lists.md): Lists the Do Not Reach suppression lists in an X Ads account
- [Create Do Not Reach List](https://docs.markifact.com/nodes/x_ads/x_ads_create_do_not_reach_list.md): Creates the Do Not Reach suppression list for an X Ads account, used to exclude specific people from all campaigns
- [Add Users To Do Not Reach List](https://docs.markifact.com/nodes/x_ads/x_ads_add_users_to_do_not_reach_list.md): Adds or removes email addresses on an X Ads Do Not Reach list
- [Delete Do Not Reach List](https://docs.markifact.com/nodes/x_ads/x_ads_delete_do_not_reach_list.md): Permanently deletes an X Ads Do Not Reach list, ending suppression for every email on it
- [Create Text Ad](https://docs.markifact.com/nodes/x_ads/x_ads_create_text_ad.md): Creates a text-only Promoted-only post in an X Ads account and promotes it in an ad group, single or many at once
- [Create Image Ad](https://docs.markifact.com/nodes/x_ads/x_ads_create_image_ad.md): Creates an image ad in an X Ads account end to end: uploads up to 4 images (GIFs too), builds a website or app card when a destination is given, creates the Promoted-only post, and promotes it
- [Create Video Ad](https://docs.markifact.com/nodes/x_ads/x_ads_create_video_ad.md): Creates a video ad in an X Ads account end to end: uploads the video and optional poster frame, builds a website or app card when a destination is given, creates the Promoted-only post, and promote...
- [Create Carousel Ad](https://docs.markifact.com/nodes/x_ads/x_ads_create_carousel_ad.md): Creates a swipeable carousel ad in an X Ads account end to end: uploads 2 to 6 images or videos, builds the carousel card with its website or app destination, creates the Promoted-only post, and pr...
