Graph API Version

Ad Creative Object Story Spec

The instagram_actor_id field for the act_<AD_ACCOUNT_ID>/adcreatives has been deprecated for v22.0 and will be deprecated for all versions January 20, 2026. Please migrate your API calls to use the instagram_user_id field. Learn more in the v22.0 API Changelog and our News for Developers blog post.

Reading

The specifications of a creative containing the page id and other content to create a new unpublished page post specified using one of link_data, photo_data, video_data, text_data or template_data.

Parameters

This endpoint doesn't have any parameters.

Fields

FieldDescription
instagram_user_id
numeric string

The Instagram user account that the ad will be posted to

link_data

The spec for a link page post or carousel ad

page_id
numeric string

ID of a Facebook page. An unpublished page post will be created on this page. User must have Admin or Editor role for this page.

photo_data

The spec for a photo page post.

product_data
list<AdCreativeProductData>

The spec for products to enable catalog related experience.

template_data

The spec for a template link page post as used in Dynamic Product Ads.

text_data

The spec for a text page post.

video_data

The spec for a video page post.

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.