Get ad preview (adsap_get_ad_preview)
Platform: Meta · Read or write: Read · Plan: All plans · Consumes a task: No · Preview supported: No
What it does
Renders a preview of an existing Meta ad using Meta’s own renderer. In assistants that support interactive cards, the preview shows Facebook Feed and Instagram Reels tabs and a button that opens every placement in Ads Manager. Video ads also get an animated clip. You can name another placement when you need one.
Parameters
Descriptions are shortened from the tool schema. Your assistant sees the full text.
| Name | Type | Required | Description |
|---|---|---|---|
ad_account_id | string | Yes | Ad account ID (act_xxx). Required: scopes the request to the workspace that owns this ad account. |
ad_id | string | Yes | The ID of the existing ad to render a preview for. |
ad_format | one of DESKTOP_FEED_STANDARD, MOBILE_FEED_STANDARD, INSTAGRAM_STANDARD, INSTAGRAM_STORY, INSTAGRAM_REELS, RIGHT_COLUMN_STANDARD, MESSENGER_MOBILE_INBOX_MEDIA, THREADS_STREAM | No | Placement to render. Use MOBILE_FEED_STANDARD (default) or INSTAGRAM_REELS: the two the interactive card presents. Other values exist only for when the user explicitly names that placement; otherwise direct them to the card’s ‘All placements on Meta’ button. |
include_video_source | boolean | No | Also resolve the ad’s raw video file URL (2 extra Meta reads, page-token lane). Default false: the bare file is NOT the preview experience (no ad chrome, placement-customized assets differ); kept for data/debug use. The upcoming animated placement preview replaces it (scope doc §8b). |
Example prompts
- “Show me a preview of ad 120210000000000.”
- “What does the new Reels ad look like?”
- “Preview this ad in Instagram Stories.”
Related tools
adsap_create_ad_from_ig_post: Turn an existing Instagram post, video, or reel into an ad inside an EXISTING ad set: Meta Ads Manager’s “Use existing post”.adsap_get_ad_library_snapshot: Show what an Ad Library ad ACTUALLY LOOKS LIKE (creative, copy, page name), in a SELF-CONTAINED card.adsap_get_creative_performance: Ranked creative performance analysis with fatigue detection.adsap_get_import_status: Check progress of a Meta historical-asset import started with adsap_import_account_creatives: status, phase (images then videos)…adsap_get_preview_clip: Fetch the animated placement-preview clip (recorded video of the real Meta preview) for an ad+placement previously rendered with…adsap_get_upload_status: Check status of an async video upload.adsap_import_account_creatives: Import ALL historical creative assets (images + videos) that already exist in a Meta ad account into the Adsap Creative Library.adsap_list_creative_assets: List uploaded Meta creative images and videos in the ad account asset library.adsap_list_drive_files: Browse Google Drive for creative image/video files to upload to Meta.adsap_list_dropbox_files: Browse Dropbox for creative image/video files to upload to Meta.adsap_list_ig_media: List an Instagram account’s recent media/posts (live from Meta): the posts, reels, and stories that can be promoted.adsap_replace_ad_creative: DESTRUCTIVE.adsap_search_ad_library: Search Meta’s public Ad Library for ads (competitor research / ad transparency).adsap_upload_creative: Upload image/video from Google Drive or Dropbox to a Meta ad account.
Guide
Read Creatives for the workflow around this tool, and the Tool reference for every tool.
Last updated on