Instagram Insights Permissions
The Instagram Insights connector requires two OAuth permissions. It also requires the Instagram account to be linked to a Facebook Page.
Required Permissions
| Scope | Purpose | Required |
|---|---|---|
instagram_basic | Basic access — name, username, followers, avatar | Required |
instagram_manage_insights | Instagram statistics via fetchInstagramInsights | Required |
instagram_basic
Purpose: retrieving basic information about the Instagram account.
API endpoint: GET /{ig_user_id}?fields=id,username,name,followers_count,media_count
What it provides:
id— Instagram account identifierusername— usernamename— display namefollowers_count— follower countmedia_count— number of postsprofile_picture_url— avatar URL
Without this permission: it's impossible to get the list of Instagram accounts.
instagram_manage_insights
Purpose: reading metrics and statistics for the Instagram account.
API endpoint: GET /{ig_user_id}/insights
What it provides:
- Reach metrics:
impressions,reach - Profile metrics:
profile_views,website_clicks - Audience metrics:
audience_gender_age,audience_country,audience_city - Content metrics:
engagement,likes,comments,saves,shares
Without this permission: only basic account fields are available, not metrics.
Additional Permissions (Indirect)
To retrieve the Instagram account through a Facebook Page, the following are also required:
| Scope | Why |
|---|---|
pages_show_list | Get the list of the user's Facebook Pages |
pages_read_engagement | Read Page data, including the linked Instagram account |
Access chain: me/accounts → Facebook Page → instagram_business_account → Instagram Insights
Account Type
Instagram Insights is only available for:
- Business accounts: full access to all metrics
- Creator accounts: access to most metrics
Personal accounts are not supported. You must switch the account to Business or Creator in Instagram settings.
Checking Permissions
Use the Facebook Access Token Debugger. Make sure both instagram_* permissions are present in the list.