> ## Documentation Index > Fetch the complete documentation index at: https://docs.markifact.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Single Video Ad > Creates new Meta ads using single video creative assets Creates new Meta ads using single video creative assets. By default it creates the full ad. It can also run in creative-only mode, which returns a creative\_id without attaching it to an ad; that creative\_id can then be used with meta\_ads\_replace\_ad\_creative. It also supports detailed-results mode: by default the response returns only IDs, while return\_detailed\_results=true returns per-row success and failure details. Detailed results are recommended for AI agents. | | | | --------------------- | --------------------------------- | | **App** | Meta Ads | | **Operation ID** | `meta_ads_create_single_video_ad` | | **Type** | Action | | **Connection** | `meta_ads` (required) | | **Credits per run** | 3 | | **Agent / MCP tool** | Yes | | **Requires approval** | Yes (write operation) | ## Inputs | Field | Type | Required | Default | Description | | ------------------------------- | --------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `account` | DynamicAccount | Yes | - | Select the Meta Ads account, ask the user for it if not provided | | `update_type` | string or SelectableOption | Yes | - | Choose how to create ads. Available options: 'single' (one ad with one video, one headline, one primary text), 'bulk' (one or many ads from structured\_data). Bulk unlocks features the single form does not have: multiple headlines, titles, and primary texts (headline\_1-5, title\_1-5, primary\_text\_1-5), a placement-specific story video with its own thumbnail, lead forms (form\_id), pixel\_id, ad scheduling (ad\_start\_time/ad\_end\_time), and sitelinks. Use bulk when an ad needs any of these. | | `page` | string or SelectItem | Yes | - | Select Facebook page, ask the user for it if not provided | | `instagram_user_id` | string or SelectItem | No | - | Optional Instagram account override. Leave empty in nearly all cases — the Instagram account linked to the selected Page is used automatically. Only set this when the user wants to advertise with a different Instagram account they have access to. Value is the numeric IG user/business account id. | | `adset_id` | string or SelectItem | No | - | Select the ad set for this ad, ask the user for it if not provided | | `ad_name` | string | No | - | Name of the ad | | `ad_status` | string or SelectableOption | No | - | Select the new status for the ad. Available options: 'ACTIVE', 'PAUSED' | | `video_url` | string | No | - | Video to use for the ad. Accepts a direct video URL or a Google Drive share link. If a Drive link is provided, Markifact automatically converts it to a direct video URL. The only requirement is that the file sharing is set to 'Anyone with the link'. For a placement-specific story video, use bulk mode. | | `thumbnail_url` | string | No | - | Leave empty to use auto-generated thumbnail | | `primary_text` | string | No | - | The main body text of the ad. For multiple text variations, use bulk mode (primary\_text\_1-5 columns). | | `headline` | string | No | - | The headline of the ad. For multiple headline variations, use bulk mode (headline\_1-5 columns). | | `title` | string | No | - | The title of your video ad | | `description` | string | No | - | Additional text that appears below the headline | | `website_url` | string | No | - | The URL where people will go when they click your ad (e.g., `https://example.com`) | | `call_to_action` | string or SelectableOption | No | - | Select a call to action button for the ad: Some Options: 'LEARN\_MORE', 'SHOP\_NOW', 'BOOK\_TRAVEL', 'DOWNLOAD', 'GET\_QUOTE', 'CONTACT\_US', 'APPLY\_NOW', 'SIGN\_UP' | | `url_parameters` | string | No | - | Add UTM or other tracking parameters to your URL (e.g., utm\_source=facebook\&utm\_medium=cpc) | | `disable_creative_enhancements` | boolean | No | - | Set to True to disable Meta's automatic creative enhancements (video auto-crop, image templates, text optimizations, dynamic media etc.) | | `disable_multi_advertiser_ads` | boolean | No | - | Set to True to opt out of Meta's multi-advertiser ads feature, which shows your ad alongside other ads. By default, Meta enables this feature. | | `display_url` | string | No | - | A custom display URL shown on the ad instead of the actual website URL (e.g., 'example.com'). This is cosmetic only and does not affect the landing page. | | `creative_only` | boolean | No | `False` | Set to true to create only the Meta ad creative without creating an ad. Useful when editing an existing ad: create a new creative with the updated video, thumbnail, text, URL, or CTA, then attach it using replace\_ad\_creative. When true, adset\_id is not required since you're not creating a new ad, just an ad creative. Returns creative IDs instead of ad IDs. Default is false. | | `return_detailed_results` | boolean | No | `False` | Bulk mode only. If true, returns per-row results (success\_count, failed\_count, total\_count, results\[]) and does NOT raise an error on partial failures so the workflow can continue. If false (default), returns a simple summary and raises an error if any row fails. | | `structured_data` | array (also accepts a comma-separated string) | No | - | Use only when update\_type is 'bulk'. This will mainly be the output of a Google Sheets read operation. Supports multiple videos with clear naming: 'video\_url' or 'default\_video\_url' (all placements), 'story\_video\_url' (story placements). Optional custom thumbnails: 'thumbnail\_url' or 'default\_thumbnail\_url' (for default video), 'story\_thumbnail\_url' (for story video). Also supports multiple text variations (headline\_1-5, title\_1-5, primary\_text\_1-5) and single 'description' field. For lead form ads, include 'form\_id' field. Optional: 'disable\_creative\_enhancements' (set to True to disable Meta's automatic creative optimizations), 'disable\_multi\_advertiser\_ads' (set to True to opt out of showing your ad alongside other ads), 'pixel\_id' (optional, leave empty to inherit from adset and account), 'display\_url' (optional, a custom display URL shown on the ad instead of the actual website URL, e.g. 'example.com'), 'ad\_start\_time' (schedule ad start, format: YYYY-MM-DD HH:MM or YYYY-MM-DD, in the ad account's timezone), 'ad\_end\_time' (schedule ad end, format: YYYY-MM-DD HH:MM or YYYY-MM-DD, in the ad account's timezone). Optional sitelinks (bulk only): leave all 'sitelink\_\*' columns blank to skip the feature. To use sitelinks, Meta requires between 4 and 20 per ad. For each one, fill in 'sitelink\_N\_title' and 'sitelink\_N\_url' (N = 1..20); 'sitelink\_N\_image\_url' is optional and accepts a direct URL or Google Drive share link. If 'sitelink\_1\_title' starts with the word 'Optional' (i.e. the template's instruction text was not cleared), all sitelinks are skipped for that row. Suggest this template for user: `https://docs.google.com/spreadsheets/d/1yAE2JDqxLFGCyHjjIQsvxn240B-ekg0B3eqcsssMQOQ/edit?gid=1444761059#gid=1444761059` | ### SelectItem | Field | Type | Required | Default | Description | | ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- | | `value` | string | Yes | - | The value of the selectable item. | | `label` | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. | ### SelectableOption | Field | Type | Required | Default | Description | | ------- | ------ | -------- | ------- | ----------- | | `value` | string | Yes | - | | | `label` | string | Yes | - | | ## Output **Type**: `Dict` Returns created ad details, a list of ad IDs and count. **Fields**: `ad_ids`, `created_count`