Release Notes

April 2026

We've implemented a new mechanism to fetch source schema quicker when creating a new connection. Now, instead of deriving the schema from source data, we use fixed schema models. This allows you to see the schema blocking and hashing screen almost immediately after creating a new connection.

As a result of this improvement, you may see empty tables and columns in the Schema tab of existing connections that have not yet synced to your destination.

We have added the following new columns to the MEDIA_INSIGHTS table:

video_photo_reposts
carousel_album_reposts
reel_reposts
reel_crossposted_views
reel_facebook_views
reels_skip_rate

We have added the following new column to the USER_INSIGHTS table:

reposts

After optimizing schema fetch for the connectors below, these connections no longer use the pre-initial-sync schema capture flow described in schema_status.

Affected connectors

REST API request changes (breaking)

For the connectors listed above, the schema_status request field is no longer supported in:

Update a Connection

If your automation still sends schema_status for these connectors, requests may fail.

REST API response changes

For the connectors listed above, schema_status is no longer returned for flows that previously exposed it, including:

If your downstream transformations or orchestration rely on this field, update them to handle its absence.

Dashboard flow change

In the Fivetran dashboard, these connectors no longer show the schema prefetch and review step before initial sync. After connection creation, you proceed directly to the initial sync flow.

January 2026

We have added the following new columns to the MEDIA_INSIGHTS table:

story_follows
video_photo_follows
carousel_album_follows
ig_reels_avg_watch_time
ig_reels_video_view_total_time

December 2025

We have upgraded our Instagram connector to version 24.0 of the Graph API. We are gradually rolling out this change to all existing connections. For more information, see Graph API's changelog.

November 2025

You can now authenticate using a System User Token as an alternative to OAuth. This authentication method is recommended for organizations that don't want to ask their end-users to grant user access, such as digital marketing agencies or Powered by Fivetran users.

For more information about setting up this authentication method, including permissions and access level requirements, see our Instagram Business setup guide.

October 2025

We unified each connector’s pre-built dbt Core–compatible data models into a single model. It standardizes and documents the Fivetran schemas created in your destination and outputs analytics-ready tables. Previously, most connectors used distinct source and transform models.

May 2025

We've added the following new columns to the USER_INSIGHTS table:

unfollower_count
comments
likes
replies
saves
shares
total_interactions
views

April 2025

We've added the owner_id column to the MEDIA_HISTORY table.

We've also added the following columns to the USER_HISTORY table:

profile_picture_url
has_profile_pic
is_published

We've also added the following columns to the MEDIA_INSIGHTS table:

carousel_album_views
carousel_album_shares
reel_views
story_views
story_shares
video_photo_views
video_photo_shares

We have upgraded our Instagram Business connector to version 22.0 of the Graph API. We are gradually rolling out this improvement to all existing connections. For more information about the changes, see Graph API's changelog.

Due to deprecations in Graph API version 22.0, we've removed the following columns from the MEDIA_INSIGHTS table:

reel_clips_replays_count
reel_aggregated_all_plays_count
reel_plays

Due to deprecations in Graph API version 22.0, we've removed the following columns from the USER_INSIGHTS table:

impressions
impressions_7d
impressions_28d

Starting from Graph API version 22.0, all impression columns will only be supported for media created before July 2, 2024. All media created after this date will have impression columns set to null. We will continue to support the impression metric on media created before this date.

This change applies to the following columns:

carousel_album_impressions
story_impressions
video_photo_impressions

December 2024

We've removed the video_views column from the MEDIA_INSIGHTS table.

We've also removed the following columns from the USER_INSIGHTS table:

email_contacts
get_direction_clicks
profile_views
phone_call_clicks
text_message_clicks
website_clicks

We made these changes because these metrics are no longer available in the Instagram API.

May 2024

We have added data that represents comments on IG Media to our Instagram Business connector. For more information, see Graph API's IG Comment.

We have added a new table, MEDIA_COMMENT, with the following fields:

created_time
hidden
id
like_count
media_id
owner_id
owner_username
parent_id
text

For more information, see the Instagram Business ERD.

March 2024

We have added a new field, story_swipe_forward, to the MEDIA_INSIGHTS table. The story_navigation_action_type field breaks down the navigation field in the MEDIA_INSIGHTS table into the following navigation actions:

story_exits
story_taps_back
story_taps_forward
story_swipe_forward

We have upgraded our Instagram Business connector to version 18.0 of the Graph API. We are gradually rolling out this improvement to all existing connections. For more information about the changes, see Graph API's changelog.

January 2024

We have added a new field, navigation, to the MEDIA_INSIGHTS table.

We have deprecated the following metrics in the MEDIA_INSIGHTS table:

carousel_album_engagement
carousel_album_impressions
carousel_album_reach
carousel_album_saved
carousel_album_video_views
story_exits
story_taps_back
story_taps_forward
video_photo_engagement

However, we kept the deprecated metrics to provide backward compatibility, and we will continue to fill them with the values that replaced them. For more details, see Instagram's changelog.

June 2023

We have upgraded our Instagram Business connector to version 17.0 of the Graph API. We are gradually rolling out this change to all existing connections. For more information about the changes, see Graph API's changelog.

March 2023

We have upgraded our Instagram Business connector from version 15.0 to 16.0 of the Graph API. Learn more about the changes in the Facebook API v16.0 changelog.

October 2022

We have upgraded our Instagram Business connector from version 14.0 to 15.0 of the Graph API. Learn more about the changes in the Facebook API v15.0 changelog.

July 2022

We have added the following new columns to the MEDIA_INSIGHTS table:

reel_comment
reel_likes
reel_plays
reel_reach
reel_shares
reel_total_interactions

June 2022

We have upgraded our Instagram Business connector from version 13.0 to 14.0 of the Graph API. Learn more about the changes in the Facebook API v14.0 changelog.

March 2022

We have upgraded our Instagram Business connector from version 12.0 to 13.0 of the Graph API. Learn more about the changes in the Facebook API v13.0 changelog.

We have expanded the public API endpoints Create a connection and Update a connection. Now you can authorize the Instagram Business connector by adding the auth section to payloads.

December 2021

We have released pre-built, dbt Core-compatible data models for Instagram Business. Find the model in Fivetran's dbt hub. Learn more about our dbt Core integration in our Transformations for dbt Core documentation.

September 2021

We have upgraded our Instagram Business connector from version 11.0 to 12.0 of the Graph API. Learn more about the changes in the Facebook API v12.0 changelog.

July 2021

Our Instagram Business connector is now generally available.

Read our Instagram Business connector documentation.

We have upgraded our Instagram Business connector from version 8.0 to 11.0 of the Graph API. Learn more about the changes in the Facebook API v11.0 changelog.

June 2021

We have added a new field, followers_count, to the USER_HISTORY table.

January 2021

Instagram Business provides metadata and insights for IG User (Instagram Business Account) and IG Media (Instagram Photo, Video, Story, or Album) objects.

Read our Instagram Business connector documentation.