📖 Instagram App Setup Guide for Stackposts

This guide explains how to create and configure a Facebook/Instagram App for Stackposts so users can connect their Instagram Business/Creator accounts, schedule content, and view insights.

1. Prerequisites

Before starting, prepare the following:

• ✅ A domain with HTTPS

• ✅ Privacy Policy: https://yourdomain.com/privacy-policy

• ✅ Terms of Service: https://yourdomain.com/terms-of-service

• ✅ Data Deletion page: https://yourdomain.com/delete-data.html

• ✅ Verified Facebook Business Manager account

• ✅ An Instagram Business or Creator account linked to a Facebook Page

• ✅ A logo (1024 × 1024 PNG)

• ✅ A support email

2. Create a Facebook App

1. Go to Meta for Developers.

2. Navigate to My Apps → Create App.

3. Choose App Type: Business, then click Next.

4. Select Use Case: Other → click Next.

5. Choose your Business Account.

6. Complete the setup → your app is created.

3. Configure Basic Settings

In App Settings → Basic:

• App Domains: yourdomain.com

• Privacy Policy URL: https://yourdomain.com/privacy-policy

• Terms of Service URL: https://yourdomain.com/terms-of-service

• User Data Deletion URL: https://yourdomain.com/delete-data.html

• App Icon: upload your 1024 × 1024 logo

• Category: Business and Pages

• Support Email: [email protected]

✅ Click Save Changes.

4. Add Products

From the left sidebar → Add Product, then add:

• Facebook Login for Business

• Instagram Graph API

5. Configure Facebook Login

Go to Facebook Login → Settings:

• Client OAuth Login → YES

• Web OAuth Login → YES

• Enforce HTTPS → YES

Valid OAuth Redirect URIs:

Data Deletion URL:

✅ Save changes.

Example delete-data.html

6. Business Verification

Go to App Dashboard → Verification:

• Business Verification: upload business docs, confirm domain, verify phone.

• Access Verification: required for Tech Providers.

✅ Both must show Verified before you can request permissions.

7. Request Instagram Permissions

1. Go to App Review → Permissions and Features.

2. Request Advanced Access for the following permissions:

• instagram_basic → access profile info & media

• instagram_content_publish → publish photos, videos, reels

• pages_show_list → list Pages that link to Instagram accounts

• business_management → required to fetch Pages/IG accounts under Business Manager

Test API Calls:

• GET /{ig-user-id}?fields=id,username → validates instagram_basic

• POST /{ig-user-id}/media → validates instagram_content_publish

• GET /me/accounts → validates pages_show_list + business_management

8. Permission Descriptions (for Review)

instagram_basic
Our app requires this permission to access Instagram Business/Creator profile information and media. It allows users to connect their Instagram accounts and manage their media library within Stackposts.

instagram_content_publish
This permission enables users to publish and schedule content (photos, videos, reels) directly to their Instagram Business/Creator accounts. It is essential for social media managers to streamline content distribution.

pages_show_list
This permission is needed to list the Facebook Pages a user manages. Since Instagram Business/Creator accounts are always linked to a Facebook Page, this is required to identify and connect the correct Instagram accounts.

business_management
This permission is required to access Instagram accounts and Facebook Pages that are part of a Business Manager. Without it, users would not be able to connect their Business-managed Instagram accounts to Stackposts.

12. After Approval

• Permissions switch to Advanced Access.

• Switch your app to Live Mode.

• Real users can now:

  • Connect Instagram accounts

  • Publish posts

  • View analytics in Stackposts

⚡ Note: Stackposts does not use webhooks for Instagram. All data is retrieved via official APIs, so no webhook configuration is required.