Meta only (facebook, instagram). When set, creates a VIDEO ad on the legacy or attach shape. Mutually exclusive with imageUrl. For multi-creative, set video per entry inside creatives[] instead.
| Name | Type | Description | Notes |
|---|---|---|---|
| url | URI | Public URL of the video. Uploaded to Meta via chunked transfer on /act_X/advideos; then the request blocks on Meta's transcoding until status.video_status === 'ready'. | |
| thumbnailUrl | URI | Public URL of a still-image thumbnail for the video. Required by Meta on every video creative. Uploaded to Meta as an ad image and referenced as the thumbnail in object_story_spec.video_data. |