Upload Media

Uploads a single image or video to a Meta ad account and returns its media reference (image_hash for images, video_id & auto-generated thumbnail_url for videos)

Uploads a single image or video to a Meta ad account and returns its media reference (image_hash for images, video_id & auto-generated thumbnail_url for videos). Use this for edge cases where you need media reference to embed in a creative payload (for example with meta_ads_create_ad_creative). For creating a full ad with new media, prefer dedicated operations such as meta_ads_create_single_image_ad.

App	Meta Ads
Operation ID	meta_ads_upload_media
Type	Action
Connection	meta_ads (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
account	DynamicAccount	Yes	-	Ad account to upload the media into. Accepts an account ID with or without the ‘act_’ prefix (for example ‘act_1234567890’ or ‘1234567890’)
image_url	string	No	-	Image to upload. Accepts a direct image URL or a Google Drive share link (set to ‘Anyone with the link’); Markifact resolves it automatically. Provide either image_url or video_url, not both. Returns an image_hash to use in an ad creative.
video_url	string	No	-	Video to upload. Accepts a direct video URL or a Google Drive share link (set to ‘Anyone with the link’); Markifact resolves it automatically. Provide either image_url or video_url, not both. Returns a video_id plus an auto-generated thumbnail_url (a video creative’s video_data needs both: video_id and image_url). Note: video upload waits for Meta to finish processing.

Output

Type: Dict

Returns the uploaded media reference (image_hash for images; video_id plus an auto-generated thumbnail_url for videos).

Fields: account_id, media_type, image_hash, video_id, thumbnail_url