Ad Formats¶
Pablo supports three types of ad creatives: image ads, carousel ads, and video ads with different asset placements for optimal display across Meta platforms.
Image Ads¶
Single-image ads with one primary asset.
Creating Image Ads¶
- Set
ad_media_type=image - Upload image to
ad_asset_urlfield - Optional: Add
ad_asset_mid_urlfor 4:5 ratio and/orad_asset_vertical_urlfor 9:16 ratio - Populate all other required fields
- Trigger your webhook automation
- Set
ad_media_type=image - Upload image to
ad_asset_urlfield - Optional: Add
ad_asset_mid_urlfor 4:5 ratio and/orad_asset_vertical_urlfor 9:16 ratio - Populate all other required fields
- Trigger your webhook automation
{
"ad_name": "Summer Sale Hero",
"ad_headline": "50% Off Everything",
"ad_body": "Limited time summer sale. Shop now!",
"ad_cta_label": "SHOP_NOW",
"ad_link_url": "https://example.com/sale",
"ad_media_type": "image",
"ad_asset_url": "https://cdn.example.com/summer-hero.jpg",
"destination_ad_account_id": "123456789",
"destination_adset_id": "987654321",
"destination_template_ad_id": "555666777"
}
Refer to Meta's specifications for Image Ads.
Video Ads¶
Video-based creatives with optional thumbnail.
Creating Video Ads¶
- Set
ad_media_type=video - Upload video to
ad_asset_urlfield - Optional: Add
ad_asset_mid_urlfor 4:5 ratio and/orad_asset_vertical_urlfor 9:16 ratio - Populate all other required fields
- Trigger your webhook automation
- Set
ad_media_type=video - Attach video to
ad_asset_urlfield - Optional: Add
ad_asset_mid_urlfor 4:5 ratio and/orad_asset_vertical_urlfor 9:16 ratio - Populate all other required fields
- Trigger your webhook automation
{
"ad_name": "Product Demo Video",
"ad_headline": "See It In Action",
"ad_body": "Watch our 30-second product demo",
"ad_cta_label": "WATCH_MORE",
"ad_link_url": "https://example.com/demo",
"ad_media_type": "video",
"ad_asset_url": "https://cdn.example.com/demo.mp4",
"video_thumbnail_url": "https://cdn.example.com/thumb.jpg",
"destination_ad_account_id": "123456789",
"destination_adset_id": "987654321",
"destination_template_ad_id": "555666777"
}
Refer to Meta's specifications for Video Ads.
Carousel Ads¶
Multi-image swipeable ads with 2-10 cards.
Creating Carousel Ads¶
- Set
ad_media_type=carousel - Upload 2-10 images to
ad_asset_urlfield (order matters) - Optional: Add
ad_asset_mid_urlfor 4:5 ratio and/orad_asset_vertical_urlfor 9:16 ratio - Populate all other required fields
- Trigger your webhook automation
- Set
ad_media_type=carousel - Attach 2-10 images to
ad_asset_urlfield (order determines card sequence) - Optional: Add
ad_asset_mid_urlfor 4:5 ratio and/orad_asset_vertical_urlfor 9:16 ratio - Populate all other required fields
- Trigger your webhook automation
{
"ad_name": "Product Collection Carousel",
"ad_headline": "New Collection",
"ad_body": "Swipe to explore our latest products",
"ad_cta_label": "SHOP_NOW",
"ad_link_url": "https://example.com/collection",
"ad_media_type": "carousel",
"ad_asset_url": [
"https://cdn.example.com/product-1.jpg",
"https://cdn.example.com/product-2.jpg",
"https://cdn.example.com/product-3.jpg"
],
"destination_ad_account_id": "123456789",
"destination_adset_id": "987654321",
"destination_template_ad_id": "555666777"
}
Notes:
- Card order is determined by upload sequence
- All cards use the same headline and CTA
- Each card links to the same destination URL
Reference¶
- Field Schema - All fields, types, and validation rules
- Placement Assets - Asset optimization and placement priorities
- Notion Integration - Notion-specific setup
- Airtable Integration - Airtable-specific setup
- API Integration - REST API documentation