📖 Documentation: Adding read_insights in Facebook API Settings

🔹 Step 1. Navigate to API Integration

1. Log in to your Stackposts Admin Dashboard.

2. Go to Settings → API Integration → Facebook.

---

🔹 Step 2. Add read_insights Permission

1. In the Facebook Page section, locate the Permissions field.

2. Add read_insights to the list of permissions.
   Example:

   pages_read_engagement,pages_manage_posts,pages_show_list,read_insights


3. Ensure your Callback URL is correctly set (e.g., https://yourdomain.com/app/facebook/page).

---

🔹 Step 3. Save Changes

• Click Save changes to update the Facebook integration settings.

---

🔹 Step 4. Re-authenticate Facebook Pages

• Users who have already connected their Facebook Pages will need to reconnect them.

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

---

🔹 Step 5. Submit read_insights for Facebook App Review

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

2. Request approval for read_insights.

3. Provide explanation + screenshots (Stackposts fetching page analytics such as reach, impressions, and engagement).

 

📊 Adding read_insights Permission for Facebook Analytics

To enable Facebook Analytics in Stackposts, your Facebook App must request and be approved for the read_insights permission. This permission allows your app to read metrics, insights, and other analytical data from Pages, Posts, and other Facebook objects.

---

🔹 Step 1. Go to Facebook App Dashboard

1. Log in to Meta for Developers.

2. Select your Facebook App used for Stackposts.

3. Navigate to App Review → Permissions and Features.

---

🔹 Step 2. Request read_insights

1. In the list of permissions, find read_insights.

2. Click Request.

3. Fill out the required details:

   • How you will use this permission → Explain that your app uses it to fetch analytics data from Facebook Pages and Posts for users who have connected their accounts in Stackposts.

   • Provide screenshots or video showing:

     • How users connect their Facebook Page in Stackposts.

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

---

🔹 Step 3. Provide Test Accounts for Review

• Add a test account with access to a Facebook Page.

• Ensure that the reviewer can:

  1. Log in via your Stackposts app.

  2. Connect a Page.

  3. See analytics data (Page reach, Post engagement, etc.) fetched using read_insights.

---

🔹 Step 4. Update Scopes in Stackposts

In your Stackposts configuration (Facebook integration), make sure you include read_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 Facebook Pages, enabling advanced analytics.

---

⚠️ Important Notes

• read_insights is a standard permission but still requires review by Meta.

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