Get started with the flexible ad format

Updated: Jun 16, 2026

The flexible ad format lets you group multiple creative assets — such as images, videos, and text — in a single ad, and the delivery system selects the format to show without you specifying one.

Before you start

Complete these steps to set up your ad campaigns for the flexible ad format:

• Create a Campaign
• Create an Ad Set
• Create the Ad or a standalone Creative
• Enable the Ad

Limitations

• Currently only OUTCOME_SALES and OUTCOME_APP_PROMOTION campaign objectives support the flexible ad format.

Create an ad using the flexible ad format

You can use creative_asset_groups_spec to provide multiple creative assets, with the following limitations:

• Each group requires at least 1 image or video.
• All call_to_actions provided must have the same type.
• There can be no more than 5 texts per text_type in a group.

For example, to create an ad using the flexible ad format through the /ads endpoint:

curl \
  -F 'adset_id=<ADSET_ID>' \
  -F "creative={
    'name': 'Sample Creative',
    'object_story_spec': {
      ...
    },
  }" \
  -F 'creative_asset_groups_spec={
  "groups": [
    {
      "images": [
        {
          "hash": <IMAGE_HASH_1>,
        },
        {
          "hash": <IMAGE_HASH_2>,
        }
      ],
      "videos": [
        {
          "video_id": <VIDEO_ID_1>,
        },
        {
          "video_id": <VIDEO_ID_2>,
        },
      ],
      "texts": [
        {
          "text": "Summer Sale",
          "text_type": "primary_text",
        },
        {
          "text": "Everything 50% Off",
          "text_type": "headline",
        }
      ],
      "call_to_action": {
        "type": "LEARN_MORE",
        "value": {
          "link": "https://www.example.com/",
        }
      }
    }
  ],
}' \
  -F 'status=PAUSED' \
  -F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

Read the flexible ad format

To check your ad, read creative_asset_group_spec:

curl -G \
  -d 'fields=creative_asset_groups_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/<AD_ID>/

Example response

{  
  "creative_asset_groups_spec": {  
    "groups": [  
      {  
        "images": [  
          {  
            "hash": <IMAGE_HASH_1>,  
          },  
          {  
            "hash": <IMAGE_HASH_2>,  
          }  
        ],  
        "texts": [  
          {  
            "text": "Summer Sale",  
            "text_type": "primary_text"  
          },  
          {  
            "text": "Everything 50% off",  
            "text_type": "headline"  
          }  
        ],  
        "videos": [  
          {  
            "video_id": <VIDEO_ID_1>,  
            "image_hash": <VIDEO_THUMBNAIL_HASH_1>  
          },  
          {  
            "video_id": <VIDEO_ID_2>,  
            "image_hash": <VIDEO_THUMBNAIL_HASH_2>  
          }  
        ],  
        "group_uuid": <GROUP_ID>  
      }  
    ]  
  },  
  "id": <AD_ID>  
}

See also

To learn more about the components and concepts mentioned in this guide, visit the following guides:

• Ad Creative
• Adgroup
• Ad Creative Object Story Spec
• Generative AI features for Ads⁠