Docs / Stackposts
Signup

Instagram Analytics

📖 Documentation: Adding instagram_manage_insights in Instagram API Settings 🔹 Step 1. Navigate to API Integration Log in to your Stackposts Admin Dashboard. Go to Setting...

Estimated reading: 3 minutes

📖 Documentation: Adding instagram_manage_insights in Instagram API Settings

🔹 Step 1. Navigate to API Integration

  • Log in to your Stackposts Admin Dashboard.

  • Go to Settings → API Integration → Instagram.

🔹 Step 2. Add instagram_manage_insights Permission

  • In the Instagram Permissions field, add instagram_manage_insights to the list of permissions.

Example:

instagram_basic,instagram_content_publish,pages_show_list,business_management,instagram_manage_insights

  • Ensure your Callback URL is correctly set (e.g.,
    https://yourdomain.com/app/instagram/profiles).

🔹 Step 3. Save Changes

  • Click Save changes to update the Instagram integration settings.

🔹 Step 4. Re-authenticate Instagram Accounts

  • Users who have already connected their Instagram Business/Creator accounts will need to reconnect them.

  • During re-authentication, they will see the additional instagram_manage_insights permission request.

🔹 Step 5. Submit instagram_manage_insights for App Review

  • Go to your Facebook App Dashboard → App Review → Permissions and Features.

  • Request approval for instagram_manage_insights.

Fill out the required details:

  • How you will use this permission → Explain that your app uses it to fetch analytics (reach, impressions, engagement, demographics) from Instagram accounts for users who have connected them in Stackposts.

  • Provide screenshots or video showing:

    • How users connect their Instagram account in Stackposts.

    • How insights (reach, impressions, engagement) are displayed inside the dashboard.

📊 Adding instagram_manage_insights Permission for Instagram Analytics

To enable Instagram Analytics in Stackposts, your app must request and be approved for the instagram_manage_insights permission.
This permission allows your app to read metrics, insights, and other analytical data from Instagram Business/Creator accounts.

🔹 Step 1. Go to Facebook App Dashboard

  • Log in to Meta for Developers.

  • Select your Facebook App used for Stackposts.

  • Navigate to App Review → Permissions and Features.

🔹 Step 2. Request instagram_manage_insights

  • In the list of permissions, find instagram_manage_insights.

  • Click Request.

  • Fill out the required details:

    • How you will use this permission → Describe that Stackposts uses it to fetch analytics from Instagram accounts (reach, impressions, engagement) for connected users.

    • Provide screenshots or demo video showing:

      • The connection flow (login with Facebook → choose IG account).

      • Analytics charts inside Stackposts using IG data.

🔹 Step 3. Provide Test Accounts for Review

  • Add a test account that has access to an Instagram Business/Creator account linked to a Facebook Page.

  • Ensure that the reviewer can:

    1. Log in via your Stackposts app.

    2. Connect an Instagram account.

    3. See analytics data (reach, impressions, engagement) fetched using instagram_manage_insights.

🔹 Step 4. Update Scopes in Stackposts

  • In your Stackposts configuration (Instagram integration), make sure you include instagram_manage_insights when requesting permissions during the login flow.

Example scopes:

instagram_basic,instagram_content_publish,pages_show_list,business_management,instagram_manage_insights

🔹 Step 5. Submit for Review

  • After preparing the explanation and demo, click Submit for Review.

  • Once approved, all Stackposts users can grant this permission when connecting their Instagram accounts, enabling advanced analytics.

⚠️ Important Notes

  • instagram_manage_insights is a standard permission but still requires Meta review.

  • Without approval, only Admins/Developers/Testers of your app can use it.

  • Ensure your app’s Privacy Policy and Terms of Service links are valid before submission.