Meta Ads / API Reference
meta_ads_create_video_ad_creative
Meta Ads tool. Create a Meta Ads creative for a video ad. Use meta_ads_upload_ad_video first to get a video_id, then call this tool. Args: name: Creative name (required). page_id: Facebook Page ID to post from (required). video_id: Meta video ID returned by meta_ads_upload_ad_video (required). message: The ad text/body copy shown above the video (required). title: Headline shown below the video. Optional. description: Description below the headline. Optional. call_to_action_type: CTA button type, e.g. LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD. Default LEARN_MORE. call_to_action_link: Destination URL for the CTA button. Required when call_to_action_type is set. 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 creative 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 creative in my Meta Ads account for [name], [page id], [video id].
It takes 4 required and 10 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name |
page_id | string | Yes | Page Id |
video_id | string | Yes | Video Id |
message | string | Yes | Message |
title | string | No | Title |
description | string | No | Description |
call_to_action_type | string | No | Call To Action Type |
call_to_action_link | string | No | Call To Action Link |
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_mediameta_ads_create_video_ad_from_sourcemeta_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: