Build a Meta dynamic creative ad with multiple asset variations

domain: developers.facebook.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create an ad creative with the dynamic_creative flag set to true; in the asset_feed_spec, provide multiple images or videos, headlines, bodies, descriptions, and call-to-action objects as separate asset arrays.
  2. Each asset type (image, headline, body) can contain multiple variants; Meta's system will automatically test combinations and serve the highest-performing variant to each viewer.
  3. Reference the creative in an ad object where the ad set's optimization_goal and billing_event are compatible with dynamic creative; dynamic creative works with most objectives but verify compatibility for your specific objective before building.
  4. Set the creative's degrees_of_freedom_spec to specify which asset types are allowed to be varied; this prevents Meta from mixing assets in unintended combinations.
  5. After the ad goes live, query the ad's creative asset combinations performance via the Insights API using the asset_feed_card_id breakdown to see which specific combinations are driving results.
  6. Regularly refresh creative assets (add new variants, retire underperformers) using the creative update endpoint; dynamic creative fatigue can set in as the algorithm converges on a narrow set of winners.

Known gotchas

Related routes

Build a Google Ads Performance Max asset group with image, text, and video assets via the API
advertising · 6 steps · unrated
Create a Meta product catalog and launch an Advantage+ catalog ad campaign via the Marketing API
advertising · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans