Meta Ads / API Reference
meta_ads_create_video_ad_from_media
Meta Ads tool. Upload video media, create a video creative, and optionally create an ad. Supports URL, file bytes, or an existing Meta `video_id`. Usually leave `media_source_type` as `auto` and let the tool detect it. Args: name: Creative name (required). page_id: Facebook Page ID to post from (required). message: Ad body copy shown above the video (required). link: Destination URL for CTA (required). media_source_value: URL, base64 file bytes, or existing video_id (required). media_source_type: Usually leave as auto. Optional override: url, file_bytes, video_id. filename: Original filename when using file_bytes. upload_title: Optional title for the uploaded video asset. headline: Headline shown below the video. description: Description shown below the headline. adset_id: If provided, create an ad in this ad set after creating the creative. ad_name: Optional ad name. Defaults to `name`. status: Ad status when `adset_id` is provided. Default PAUSED. call_to_action_type: CTA button type. Default LEARN_MORE. account_id: Ad account ID. Leave blank to use .env default. thumbnail_image_hash: Optional Meta image hash to use as the video thumbnail. thumbnail_image_url: Optional public image URL to use as the video thumbnail. wait_for_video_ready: Wait for Meta to expose a usable thumbnail when no thumbnail is passed. timeout_seconds: Max seconds to wait for video readiness. poll_seconds: Poll interval while waiting for readiness.
This is a write tool: it creates video ad from media 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:
Create video ad from media in my Meta Ads account for [name], [page id], [message].
It takes 5 required and 15 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name |
page_id | string | Yes | Page Id |
message | string | Yes | Message |
link | string | Yes | Link |
media_source_value | string | Yes | Media Source Value |
media_source_type | string | No | Media Source Type |
filename | string | No | Filename |
upload_title | string | No | Upload Title |
headline | string | No | Headline |
description | string | No | Description |
adset_id | string | No | Adset Id |
ad_name | string | No | Ad Name |
status | string | No | Status |
call_to_action_type | string | No | Call To Action Type |
account_id | string | No | Account Id |
thumbnail_image_hash | string | No | Thumbnail Image Hash |
thumbnail_image_url | string | No | Thumbnail Image Url |
wait_for_video_ready | boolean | No | Wait For Video Ready |
timeout_seconds | integer | No | Timeout Seconds |
poll_seconds | integer | No | Poll Seconds |
Related Meta Ads tools
meta_ads_create_video_ad_from_sourcemeta_ads_create_video_ad_creativemeta_ads_create_ab_testmeta_ads_create_admeta_ads_create_ad_creativemeta_ads_create_adset
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: