Meta Ads / API Reference
meta_ads_upload_ad_video
Meta Ads tool. Upload a video to Meta's ad video library from a public URL. Downloads the file locally first, then uploads it via multipart so signed, redirected, and Google Drive URLs work more reliably than Meta-side fetches. Args: file_url: Public URL of the video file. Google Drive share links are supported. title: Optional title for the video in the library. account_id: Ad account ID. Leave blank to use .env default. wait_for_ready: Wait for Meta processing before returning. Default true. timeout_seconds: Max seconds to wait when wait_for_ready is true. Default 180. poll_seconds: Poll interval while waiting for ready status. Default 5. Returns: JSON with video_id plus readiness, processing status, and thumbnail when available.
This is a write tool: it uploads ad video in your Meta Ads account. Claude asks you to confirm before it runs.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Upload ad video in my Meta Ads account for [file url].
It takes 1 required and 5 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
file_url | string | Yes | File Url |
title | string | No | Title |
account_id | string | No | Account Id |
wait_for_ready | boolean | No | Wait For Ready |
timeout_seconds | integer | No | Timeout Seconds |
poll_seconds | integer | No | Poll Seconds |
Related Meta Ads tools
meta_ads_upload_customer_list_to_audiencemeta_ads_upload_enhanced_conversionsmeta_ads_upload_image_file_bytes_to_metameta_ads_upload_image_to_metameta_ads_upload_product_feedmeta_ads_upload_video_file_bytes_to_meta
Before you can call it
This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: