Upload creative (adsap_upload_creative)
Platform: Meta · Read or write: Write · Plan: All plans · Consumes a task: No · Preview supported: No
What it does
Uploads an image or video from Google Drive or Dropbox into a Meta ad account’s creative library. You point at one file per call, from one source. The upload can group files named as a square and vertical pair. Video uploads run in the background, so check their status afterwards.
Parameters
Descriptions are shortened from the tool schema. Your assistant sees the full text.
| Name | Type | Required | Description |
|---|---|---|---|
ad_account_id | string | Yes | |
drive_file_id | string | No | From adsap_list_drive_files. Provide exactly one of drive_file_id / dropbox_path. |
dropbox_path | string | No | From adsap_list_dropbox_files (its dropbox_path field, e.g. ‘/creatives/ad.jpg’). Provide exactly one of drive_file_id / dropbox_path. |
name | string | No | Defaults to the source filename. |
type | one of IMAGE, VIDEO | No | Auto-detected if omitted. |
labels | array of string | No | Adsap-only tags, not in Meta. |
pair | boolean | No | Set true on EACH file of a square/vertical (+optional landscape) set whose filenames share a base name with matching suffixes (e.g… Pairing happens server-side when the partner file lands, in any order. |
idempotency_key | string | No |
Example prompts
- “Upload the file summer-hero.mp4 from my Drive to the UK ad account.”
- “Upload both files of the blue-sneaker pair from Dropbox and group them as one creative.”
- “Push the three product images in the Q3 Drive folder into the creative library and tag them Q3.”
Notes
Give exactly one source per upload: a Drive file id or a Dropbox path, never both.
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_ad_preview: Render a pixel-accurate visual preview of an existing Meta ad (real Meta render; video ads also get an animated clip in the interactive…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).
Guide
Read Creatives for the workflow around this tool, and the Tool reference for every tool.
Last updated on