Get started with the flexible ad format

Updated: Jun 16, 2026

Copy for LLM

Ads in WhatsApp Status are available via the Marketing API. Learn more about ads in WhatsApp Status.

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/v26.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/v26.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>
}