Instagram Marketing API Legacy Fields Deprecation Scheduled for September Update

The Marketing API v21.0 will be deprecated on September 9, 2025, which is earlier than the previously announced date of January 21, 2026. After this date, no version of the Marketing API will support legacy Instagram fields.

Changes in Fields

With the introduction of Marketing API v22.0, the legacy fields ‘instagram_actor_id’, ‘instagram_story_id’, and ‘effective_instagram_story_id’ will be replaced by ‘instagram_user_id’, ‘source_instagram_media_id’, and ‘effective_instagram_media_id’. This change is part of Meta's efforts to consolidate API endpoints and enhance coherence across the Instagram Graph API and Marketing API.

Impact on Developers

Developers using Instagram legacy fields in their Marketing API integrations are urged to migrate to the new fields before September 9, 2025, to maintain uninterrupted functionality. Those automatically updating their Graph API versions should review these changes, as they take effect immediately with Graph API v22.0.

API Calls to Update

Developers need to update the following API calls:

• GET /<adset_id>?fields=instagram_actor_id
• GET /<adgroup_id>?fields=creative{instagram_actor_id}
• GET /<adcreative_id>?fields=instagram_actor_id,instagram_story_id,effective_instagram_story_id
• GET /<adcreative_id>?fields=object_story_spec{instagram_actor_id}
• GET /generatepreviews
• GET /act_<adaccount_id>/generatepreviews
• POST /act_<adaccount_id>/adcreatives
• POST /act_<adaccount_id>/ads
• POST /act_<adaccount_id>/asyncadrequestsets
• POST /<adgroup_id>
• POST /<adgroup_id>/copies

For further details and implementation guidelines, developers should refer to the developer documentation.