> ## 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

> Create single video ads or bulk upload multiple video ads in Meta Ads

The **Create Single Video Ad** node lets you create engaging video ads for Facebook and Instagram campaigns. Supports both single ad creation and bulk uploads using Google Sheets templates with multi-asset capabilities.

***

## When to Use It

* Create individual video ads for specific campaigns
* Bulk upload multiple video ads at once with multi-asset support
* Create placement-specific video creatives (Stories, Feed, Right Column)
* Test multiple ad copy variations simultaneously
* Automate video ad creation from content libraries
* Scale video ad creation for A/B testing different creatives
* Generate dynamic video ads from AI-generated or existing content

***

## Inputs

| Field               | Type           | Required | Description                                        | Applies To |
| ------------------- | -------------- | -------- | -------------------------------------------------- | ---------- |
| **Account**         | Select         | Yes      | Select a Meta Ads account                          | Both       |
| **Creation Type**   | Tabs           | Yes      | Choose "Single Ad" or "Bulk Ads"                   | Both       |
| **Page**            | Dynamic-select | Yes      | Select Facebook page for the ads                   | Both       |
| **Structured Data** | Dynamic-text   | Yes      | Data source containing ad information              | Bulk Ads   |
| **Ad Set ID**       | Dynamic-select | Yes      | Select the ad set for this ad                      | Single Ad  |
| **Ad Name**         | Dynamic-text   | Yes      | Name of the ad                                     | Single Ad  |
| **Ad Video**        | Video          | Yes      | Upload or select a video for the ad                | Single Ad  |
| **Thumbnail Image** | Image          | No       | Custom thumbnail (auto-generated if empty)         | Single Ad  |
| **Primary Text**    | Text-area      | Yes      | The main body text of the ad                       | Single Ad  |
| **Headline**        | Dynamic-text   | No       | The headline of the ad                             | Single Ad  |
| **Title**           | Dynamic-text   | No       | The title of your video ad                         | Single Ad  |
| **Website URL**     | Dynamic-text   | Yes      | URL where people go when they click the ad         | Single Ad  |
| **Call to Action**  | Dynamic-select | Yes      | Call-to-action button for the ad                   | Single Ad  |
| **Ad Status**       | Select         | Yes      | Initial status (ACTIVE or PAUSED, default: PAUSED) | Single Ad  |
| **URL Parameters**  | Dynamic-text   | No       | UTM or tracking parameters                         | Single Ad  |

### Video Requirements

Meta Ads video specifications:

**Design Specifications:**

* **File type**: MP4, MOV or GIF
* **Aspect ratio**: 1:1 (for desktop or mobile) or 4:5 (for mobile only)
* **Video settings**: H.264 compression, square pixels, fixed frame rate, progressive scan and stereo AAC audio compression at over 128 kbps
* **Recommended resolution**:
  * 1:1 ratio: 1440 x 1440 pixels
  * 4:5 ratio: 1440 x 1800 pixels
* **Video captions**: Optional, but recommended
* **Video sound**: Optional, but recommended

**Technical Requirements:**

* **Video duration**: 1 second to 241 minutes
* **Maximum file size**: 4 GB
* **Minimum width**: 120 pixels
* **Minimum height**: 120 pixels

**Additional Notes:**

* Videos should not contain edit lists or special boxes in file containers
* The thumbnail in the ad footer is sourced directly from the video thumbnail chosen by advertisers during the ad creation workflow

### Bulk Upload Template

For bulk ad creation with multi-asset support, use the [Google Sheets template](https://docs.google.com/spreadsheets/d/1yAE2JDqxLFGCyHjjIQsvxn240B-ekg0B3eqcsssMQOQ/edit?gid=1444761059#gid=1444761059) with these columns:

#### Required Columns

| Column                                    | Description                                                                                                           | Required |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | -------- |
| **adset\_id**                             | Ad set ID where the ad will be created                                                                                | Yes      |
| **ad\_name**                              | Name for the ad                                                                                                       | Yes      |
| **ad\_status**                            | ACTIVE or PAUSED                                                                                                      | Yes      |
| **video\_url** OR **default\_video\_url** | Main video for all placements. Use `video_url` for simple bulk uploads or `default_video_url` for multi-asset uploads | Yes      |
| **website\_url**                          | Landing page URL                                                                                                      | Yes      |
| **call\_to\_action**                      | CTA button type (LEARN\_MORE, SHOP\_NOW, etc.)                                                                        | Yes      |
| **primary\_text** OR **primary\_text\_1** | Main ad copy. Use `primary_text` for simple uploads or `primary_text_1` for multi-asset                               | Yes      |

#### Optional Multi-Asset Columns (New Feature)

| Column                                             | Description                                                                | Usage    |
| -------------------------------------------------- | -------------------------------------------------------------------------- | -------- |
| **default\_thumbnail\_url**                        | Custom thumbnail for main video (auto-generated if not provided)           | Optional |
| **story\_video\_url**                              | Dedicated video for Stories and Reels placements on Facebook and Instagram | Optional |
| **story\_thumbnail\_url**                          | Custom thumbnail for Stories video (auto-generated if not provided)        | Optional |
| **right\_column\_image\_url**                      | Static image for Facebook Right Column and Search placements               | Optional |
| **primary\_text\_2** to **primary\_text\_5**       | Additional primary text variations (up to 5 total)                         | Optional |
| **headline** OR **headline\_1** to **headline\_5** | Single headline or multiple headline variations (up to 5 total)            | Optional |
| **title**                                          | Video title                                                                | Optional |
| **url\_parameters**                                | UTM tracking parameters                                                    | Optional |

### Multi-Asset Benefits

When you provide multiple assets in the bulk upload:

* **Placement Optimization**: Different videos for Stories vs Feed, static images for Right Column
* **Text Variations**: Up to 5 primary text and headline variations per ad
* **Automatic Testing**: Meta's system will test different combinations to find the best performers
* **Enhanced Performance**: Placement-specific creatives typically perform better than one-size-fits-all assets

***

## Output

Returns the created ad IDs and count:

```json theme={"dark"}
{
  "ad_ids": ["120210543987640123", "120210543987640124"],
  "created_count": 2
}
```

**Single Ad Output:**

* `ad_ids`: Array containing the new ad ID
* `created_count`: Number of ads created (1)

**Bulk Ads Output:**

* `ad_ids`: Array of all successfully created ad IDs
* `created_count`: Total number of ads created

***

## Credit Cost

* **Cost per run**: 3 credits per ad created (single ad = 3 credits, 10 bulk ads = 30 credits)

***

## FAQs

<Accordion title="Should I use a custom thumbnail or auto-generated?">
  **Custom thumbnail** when:

  * You want consistent branding across ads
  * The auto-generated frame isn't compelling
  * You need specific text or graphics overlay
  * You're A/B testing thumbnail impact

  **Auto-generated** when:

  * The video has strong opening frames
  * You want to save time in bulk uploads
  * The video is well-designed from start to finish
  * You're testing video content variations
</Accordion>

<Accordion title="What video formats work best for different placements?">
  Recommended formats by placement:

  * **Facebook/Instagram Feed**: 1:1 (square) or 4:5 (mobile optimized)
  * **Stories**: 4:5 (vertical) - optimal for mobile viewing
  * **Desktop placements**: 1:1 (square) works well
  * **Universal**: 1:1 (square) recommended for all placements

  Note: This node follows Meta's current specifications of 1:1 or 4:5 aspect ratios, which work across all placements.
</Accordion>

<Accordion title="Does this node support carousel video ads?">
  No, this node only creates **single video ads**. For carousel ads (multiple videos in one ad), you'll need to:

  * Use a different ad creation method outside of Markifact
  * Create multiple single video ads instead
  * Consider using image carousel ads if you want to showcase multiple products

  Each execution of this node creates one ad with one video, regardless of single or bulk mode.
</Accordion>

<Accordion title="Can I customize ads for specific placements (Instagram vs Facebook)?">
  No, this node doesn't support placement-specific customization. All ads created will use the same video and copy across all placements where your ad set is configured to show.

  **Current limitation**: You cannot create:

  * Different videos for Instagram Stories vs Facebook Feed
  * Specific creative for Facebook Reels
  * Placement-optimized versions within the same ad

  **Workaround**: Create separate ad sets with different placement targeting, then use this node to create placement-specific ads for each ad set.
</Accordion>

<Accordion title="What Call to Action options are available?">
  Popular CTA options include:

  * **LEARN\_MORE**
  * **SHOP\_NOW**
  * **ORDER\_NOW**
  * **CONTACT\_US**
  * **SUBSCRIBE**
  * **APPLY\_NOW**
  * **SIGN\_UP**
  * **DOWNLOAD**
  * **GET\_OFFER**
  * **BUY\_NOW**
  * **CALL\_NOW**
  * **INSTALL\_APP**
  * **WATCH\_VIDEO**
  * **NO\_BUTTON**

  For the complete list, see the [Meta Marketing API documentation](https://developers.facebook.com/docs/marketing-api/reference/ad-account/adcreatives).
</Accordion>

<Accordion title="How do I create Meta video ads in bulk with multiple assets?">
  To create ads with multiple videos and text variations:

  1. **Access the template**: Use the [Google Sheets bulk upload template](https://docs.google.com/spreadsheets/d/1yAE2JDqxLFGCyHjjIQsvxn240B-ekg0B3eqcsssMQOQ/edit?gid=1444761059#gid=1444761059)

  2. **Fill required columns**:
     * `adset_id`: Your target ad set ID
     * `ad_name`: Unique name for each ad
     * `ad_status`: PAUSED or ACTIVE
     * `default_video_url`: Main video (required)
     * `website_url`: Landing page URL
     * `call_to_action`: CTA button type
     * `primary_text_1`: Main ad copy

  3. **Add placement-specific videos** (optional):
     * `story_video_url`: For Stories and Reels (9:16 aspect ratio recommended)
     * `right_column_image_url`: Static image for Facebook Right Column (1:1 aspect ratio)

  4. **Include custom thumbnails** (optional):
     * `default_thumbnail_url`: Custom thumbnail for main video
     * `story_thumbnail_url`: Custom thumbnail for Stories video

  5. **Add text variations** (optional):
     * `primary_text_2` to `primary_text_5`: Additional copy variations
     * `headline_1` to `headline_5`: Multiple headline options
     * `title`: Video title

  6. **Connect and run**: Select "Bulk Ads" mode and connect your Google Sheet as structured data

  **Example row:**

  ```
  adset_id: 120xxxxxxxx
  ad_name: "Product Demo Video"
  ad_status: PAUSED
  default_video_url: "https://drive.google.com/..."
  story_video_url: "https://drive.google.com/..."
  primary_text_1: "See our product in action!"
  primary_text_2: "Watch how easy it is to use!"
  headline_1: "Product Demo"
  headline_2: "See It Work"
  website_url: "https://mystore.com/demo"
  call_to_action: WATCH_VIDEO
  ```

  **Pro tip**: Meta's system will automatically test different combinations of your assets to find the best performers.
</Accordion>

<Accordion title="What are the video requirements for different placements?">
  Each placement has specific video requirements:

  **Default Video (required):**

  * **Aspect ratio**: 1:1 or 4:5
  * **Recommended**: 1:1 (1440 x 1440px) for best compatibility
  * **Use**: Facebook Feed, Instagram Feed, and most standard placements

  **Story Video (optional):**

  * **Aspect ratio**: 9:16 (vertical)
  * **Recommended**: 1080 x 1920px
  * **Use**: Facebook Stories, Instagram Stories, Instagram Reels

  **Right Column Image (optional):**

  * **Type**: Static image (not video)
  * **Aspect ratio**: 1:1 (square)
  * **Recommended**: 1200 x 1200px
  * **Use**: Facebook Right Column, Facebook Search results

  **Universal Requirements:**

  * **File type**: MP4, MOV or GIF
  * **Duration**: 1 second to 241 minutes
  * **Maximum file size**: 4 GB
  * **Compression**: H.264 with AAC audio

  💡 **Pro Tip**: Create shorter videos (15-30 seconds) for Stories and longer, more detailed videos for Feed placements.
</Accordion>

<Accordion title="How many text variations should I include for video ads?">
  **Best practices for video ad text variations:**

  **Primary Text (up to 5 variations):**

  * Include 2-3 variations minimum for testing
  * Focus on different angles: benefit-driven, curiosity-driven, action-oriented
  * Keep each under 125 characters for optimal performance

  **Headlines (up to 5 variations):**

  * Test 2-4 different headlines
  * Match the video content theme
  * Keep under 27 characters for maximum visibility

  **Video Title:**

  * Single title per ad
  * Describes the video content
  * Appears in some placements

  **Example variations:**

  ```
  Primary Text 1: "Watch how our tool saves 2 hours daily"
  Primary Text 2: "See the before and after transformation"
  Primary Text 3: "Join 10,000+ users who love this feature"

  Headline 1: "Time Saver"
  Headline 2: "See Results"
  Headline 3: "Join Thousands"

  Title: "Product Demo: Daily Workflow"
  ```

  Meta's algorithm will test combinations and optimize for the best performing assets.
</Accordion>

<Accordion title="How do I use Google Drive videos in bulk uploads?">
  Using Google Drive videos in your bulk uploads is simple:

  **Steps to prepare Google Drive videos:**

  1. **Upload your video** to Google Drive
  2. **Right-click** on the video file
  3. **Select "Share"** from the menu
  4. **Set access** to "Anyone with the link" (Viewer permissions)
  5. **Click "Copy link"** and paste it directly into your template

  **That's it!** You can use the regular Google Drive sharing link directly in your bulk upload template. Markifact automatically converts it to the proper format for Meta Ads.

  **Example of what you can paste directly:**

  ```
  https://drive.google.com/file/d/11j-rCp9wgrV44y4G33emLY-VVcLFlSgN/view?usp=sharing
  ```

  **No conversion needed** - just make sure the file is shared publicly with "Anyone with the link" permissions.

  **Important notes for videos:**

  * Ensure your video meets Meta's file size limits (4 GB max)
  * This method works for both videos and thumbnail images
  * Video processing may take longer, so allow extra time for bulk uploads

  **Pro tip**: Test your sharing link in an incognito browser window to ensure it's publicly accessible before using it in your bulk upload template.
</Accordion>

<Accordion title="Can I upload videos directly in the bulk template?">
  Yes! You have several options for providing videos:

  **Direct Upload:**

  * Use the video uploader within the ad creation node
  * Generate publicly accessible URLs automatically
  * Most convenient for new videos

  **External URLs:**

  * Google Drive public links
  * Cloud storage URLs (Dropbox, OneDrive, etc.)
  * Your website's video URLs
  * CDN-hosted videos

  **Requirements for external URLs:**

  * Must be publicly accessible (no login required)
  * Direct link to the video file
  * HTTPS recommended for security
  * Stable URLs that won't expire

  **Pro tip for Google Drive**:

  1. Upload your video to Google Drive
  2. Right-click and select "Get link"
  3. Change permissions to "Anyone with the link can view"
  4. Use the sharing URL in your template

  **Note**: Video processing may take longer than image uploads, so allow extra time for bulk video ad creation.
</Accordion>

<Accordion title="How do I create Meta video ads in bulk?">
  To create multiple video ads at once:

  1. **Access the template**: Use the [Google Sheets bulk upload template](https://docs.google.com/spreadsheets/d/1yAE2JDqxLFGCyHjjIQsvxn240B-ekg0B3eqcsssMQOQ/edit?gid=1444761059#gid=1444761059)

  2. **Choose your format**:
     * **Simple bulk upload**: Use `video_url`, `primary_text`, `headline` (same as before)
     * **Multi-asset upload**: Use `default_video_url`, `primary_text_1`, `headline_1` + additional variations

  3. **Fill required columns**: Add adset\_id, ad\_name, ad\_status, video\_url (or default\_video\_url), website\_url, call\_to\_action, and primary\_text (or primary\_text\_1) for each ad

  4. **Upload videos**: Ensure all videos are accessible via direct URLs and meet Meta's video requirements

  5. **Connect template**: In the node, select "Bulk Ads" mode and connect your Google Sheet as structured data

  6. **Run the workflow**: The node will create all ads simultaneously

  **Pro tip**: Start with 2-3 ads to test your setup before scaling to larger batches. Video processing may take longer than image ads. You can mix simple and multi-asset formats in the same sheet.
</Accordion>