📖 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:

• 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:

---

🔹 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.