Field Name

Modifier & Defaults

Type

Description

creative_type

Read-only (on GET)

Required for motion ads (on POST)

String

Possible values:

STATIC_IMAGE
PERFORMANCE_VIDEO
CAROUSEL
DISPLAY

The creative format type.

For static ads, this field is automatically set based on the item content.

For motion ads, set creative_type to PERFORMANCE_VIDEO when creating the item.

📘
Creative type guidelines

STATIC_IMAGE - A standard image-based ad.

PERFORMANCE_VIDEO - A motion ad (video). Requires performance_video_data with video_url and fallback_url.

CAROUSEL - A multi-card ad with multiple images. Contains child items.

DISPLAY - A display ad format. Requires display_data.

🚧
Creating motion ads
When creating motion ads, you must set creative_type to PERFORMANCE_VIDEO and provide the performance_video_data object. See Motion Ads Overview for details.