Collection ad
A cover creative over a product grid drawn from a catalog product set.
A collection ad shows a hero (cover) creative above a grid of products pulled from a Meta catalog product set. Tapping it opens an Instant Experience storefront.
When to use this
You have a product catalog and want a mobile storefront experience seeded from a product set.
Example body
POST /meta/launches
Every key applicable to a collection ad, with sample values. Required: adName, adSets, cover creatives[]._id, adProfiles, cta, webLink, productSetId, defaultHeadline.
{
"adAccountId": "01H8Y4...",
"platform": "meta",
"ads": [
{
"adName": "Spring Collection",
"adSets": ["123456789012345"],
"creativeDetails": {
"groupType": "collection",
"creatives": [
{
"_id": "01H8YA...",
"productHeadline": "Spring Collection",
"productDescription": "Shop the full range"
}
]
},
"adProfiles": {
"facebook_page_id": "123456789012345",
"instagram_account_id": "987654321098765",
"page_backed_instagram_account_id": null
},
"productSetId": "678901234567",
"productSetData": {
"business_id": "1029384756",
"catalog_id": "456789012345",
"product_set_id": "678901234567"
},
"cta": "SHOP_NOW",
"defaultPrimaryText": "Explore the spring collection.",
"primaryTextVariations": ["Shop the spring range", "New season is live"],
"defaultHeadline": "Spring Collection",
"headlineVariations": ["Up to 40% off", "New arrivals"],
"adDescription": "Free shipping on orders over $50.",
"webLink": "https://example.com/spring",
"displayLink": "example.com/spring",
"utm": "utm_source=facebook&utm_medium=cpc&utm_campaign=spring",
"leadGenFormId": null,
"adSchedule": { "startDate": "2026-06-01T00:00:00Z", "endDate": "2026-06-30T23:59:59Z" },
"promoCodeDetails": { "type": "manual", "manualCodes": ["SPRING40", "EARLYBIRD"] },
"aiMediaDisclosure": true
}
]
}Full schema: Create a launch.
Required fields
adName,adSetscreativeDetails.creatives[]._id(the cover creative)adProfiles— at least one offacebook_page_id/instagram_account_idctawebLinkproductSetId(or fullproductSetData) — the product grid sourcedefaultHeadline— collection ads always require a headline
Missing productSetId or defaultHeadline is rejected (400). The server mints ads[].id and creativeDetails.groupId.
Optional fields
Per-creative productHeadline / productDescription; ad-level defaultPrimaryText, headlineVariations, adDescription, displayLink, utm, adSchedule, promoCodeDetails, leadGenFormId, aiMediaDisclosure.
Field notes
productSetId— required; the product set whose items fill the grid. Resolve it from List catalogs (each catalog row carries its product sets inline). Or pass the fullproductSetDataobject (business_id/catalog_id/product_set_id).creatives[0]— the cover asset.productHeadline/productDescriptionlabel the storefront.
Gotchas
- The catalog and product set must belong to a business the ad account can access — see List businesses.
- Exactly one cover creative.
- Not supported on App-conversion ad sets — see Ad set compatibility.
