Skip to main content

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.

The Create Carousel Ad node lets you create professional carousel ads for Facebook and Instagram campaigns. Carousel ads showcase multiple images or videos in a single ad, allowing users to swipe through different cards. This node only supports bulk creation using Google Sheets templates.

When to Use It

  • Showcase multiple products in a single ad
  • Tell a story across multiple cards
  • Highlight different features of a single product
  • Create interactive shopping experiences
  • Display before/after sequences
  • Show step-by-step tutorials or processes
  • Increase engagement with swipeable content
  • Test different creative combinations within one ad

Inputs

FieldTypeRequiredDescription
AccountSelectYesSelect a Meta Ads account
PageDynamic-selectYesSelect Facebook page for the ads
Structured DataDynamic-textYesGoogle Sheets data containing carousel ad information

Bulk Upload Template

For carousel ad creation, use the Google Sheets template with these columns:

Required Columns

ColumnDescriptionRequired
adset_idAd set ID where the carousel ad will be createdYes
ad_nameName for the carousel adYes
ad_statusACTIVE or PAUSED (recommended: PAUSED for review)Yes
primary_textMain ad copy that appears above the carouselYes
website_urlDefault landing page URL for all cardsYes
card_1_media_urlImage or video URL for the first cardYes
card_1_headlineHeadline text for the first cardYes
card_2_media_urlImage or video URL for the second cardYes
card_2_headlineHeadline text for the second cardYes

Optional Columns

ColumnDescriptionUsage
card_N_descriptionDescription text for card N (where N = 1-10)Optional
card_N_website_urlSpecific landing URL for card N (overrides default website_url)Optional
card_N_call_to_actionCall-to-action button for card N (e.g., SHOP_NOW, LEARN_MORE)Optional
card_N_story_media_urlDedicated media for Stories placement for card NOptional
form_idLead form ID for lead generation carousel adsOptional

Additional Cards (3-10)

For cards 3 through 10, you can add:
  • card_N_media_url and card_N_headline (both required if any card_N field is provided)
  • Any of the optional columns listed above
Important: If you provide ANY field for a card (3-10), then both card_N_media_url AND card_N_headline become required for that card.

Card Requirements

Media Specifications

Images:
  • File type: JPG or PNG
  • Aspect ratio: 1:1 (square) recommended for best display
  • Recommended resolution: 1080 x 1080 pixels
  • Maximum file size: 30 MB
  • Minimum resolution: 600 x 600 pixels
Videos:
  • File type: MP4, MOV, or GIF
  • Aspect ratio: 1:1 (square) or 4:5 (vertical)
  • Maximum file size: 4 GB
  • Maximum duration: 240 minutes
  • Recommended duration: 15 seconds or less for optimal performance
  • Video thumbnails: Auto-generated by Meta

Content Guidelines

Card Limits:
  • Minimum: 2 cards per carousel
  • Maximum: 10 cards per carousel
  • Optimal: 3-5 cards for best performance
Text Requirements:
  • Primary text: 125 characters or less for optimal display
  • Card headlines: 25 characters or less for maximum visibility
  • Card descriptions: 20 characters or less when used

Output

Returns the created carousel ad IDs and count:
{
  "ad_ids": ["120210543987640123", "120210543987640124"],
  "created_count": 2
}
  • ad_ids: Array of all successfully created carousel ad IDs
  • created_count: Total number of carousel ads created

Credit Cost

  • Cost per run: 3 credits per carousel ad created
  • Example: 5 carousel ads = 15 credits

FAQs

Yes! You can set different landing URLs for each card using the card_N_website_url columns in your template.Use cases:
  • Link each product card to its specific product page
  • Direct users to different category pages
  • Send traffic to relevant blog posts or resources
  • A/B test different landing pages within one ad
Fallback: If you don’t specify a card-specific URL, it will use the default website_url from your template.