Instagram Marketing API stopt op 9 september 2025 met legacy-velden

De Marketing API v21.0 wordt op 9 september 2025 uitgefaseerd, eerder dan de eerder aangekondigde datum van 21 januari 2026. Vanaf dat moment ondersteunt geen enkele versie van de Marketing API nog de legacy Instagram-velden.

Wijzigingen in velden

Met de introductie van Marketing API v22.0 worden de legacy-velden:

  • instagram_actor_id
  • instagram_story_id
  • effective_instagram_story_id

Vervangen door:

  • instagram_user_id
  • source_instagram_media_id
  • effective_instagram_media_id

Deze wijziging maakt deel uit van Meta’s inspanningen om API-endpoints te consolideren en de samenhang tussen de Instagram Graph API en Marketing API te verbeteren.

Impact voor ontwikkelaars

Ontwikkelaars die in hun Marketing API-integraties nog legacy Instagram-velden gebruiken, worden dringend aangeraden vóór 9 september 2025 over te stappen op de nieuwe velden om onderbrekingen te voorkomen.

Voor ontwikkelaars die hun Graph API-versies automatisch updaten, gelden deze wijzigingen direct bij versie Graph API v22.0.

Aanpassingen in API-calls

Ontwikkelaars moeten de volgende API-calls aanpassen:

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