# Upload creative (adsap_upload_creative)

Uploads an image or video from Google Drive or Dropbox into a Meta ad account's creative library.

Canonical: https://adsap.ai/docs/tools/adsap_upload_creative
Updated: 2026-09-13

**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`](/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/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`](/tools/adsap_replace_ad_creative): DESTRUCTIVE.
- `adsap_search_ad_library`: Search Meta's public Ad Library for ads (competitor research / ad transparency).

## Guide

Read [Creatives](/guides/creatives) for the workflow around this tool, and the [Tool reference](/tools) for every tool.