Skip to main content
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.
I