API Integration – Social Media APIs

Facebook API Official

Estimated reading: 8 minutes

📘 Facebook App Setup for Stackposts

1. Prerequisites

Before creating your Facebook App, prepare the following:

✅ Secure domain with HTTPS (e.g., https://yourdomain.com)
✅ Privacy Policy page → https://yourdomain.com/privacy-policy
✅ Terms of Service page → https://yourdomain.com/terms-of-service
✅ Data Deletion page → https://yourdomain.com/delete-data.html
✅ Business account on Meta Business Manager that is Business Verified
✅ App logo (1024 × 1024, PNG or JPG)
✅ Support email (e.g., [email protected])
✅ Active Meta Developer account

2. Create a Facebook App

Go to Meta for Developers.
Click My Apps → Create App.
Select App Type = Business → click Next.
On Use Cases, scroll down and select Other → click Next.
- ⚠️ Choosing Other ensures you can manually configure all needed permissions.
Select your verified Business account.
Finish app creation.

3. Configure Basic App Settings

Navigate to App Settings → Basic and fill in:

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 1024 × 1024 logo
Category: Business and Pages
Support Email: [email protected]

Click Save changes.

⚠️ Without these, your app will show “Currently Ineligible for Submission.”

Example file delete-data.html :

<!DOCTYPE html>
<html lang=”en”>
<head>
<meta charset=”UTF-8″>
<meta name=”viewport” content=”width=device-width, initial-scale=1.0″>
<title>Data Deletion Instructions</title>
<style>
body {
font-family: ‘Segoe UI’, Tahoma, Geneva, Verdana, sans-serif;
background: #f9fafb;
margin: 0;
padding: 0;
color: #333;
}
.container {
max-width: 700px;
margin: 60px auto;
background: #fff;
padding: 40px;
border-radius: 16px;
box-shadow: 0 6px 18px rgba(0,0,0,0.1);
text-align: center;
}
h1 {
font-size: 28px;
margin-bottom: 16px;
color: #675dff; /* primary brand color */
}
p {
font-size: 16px;
line-height: 1.6;
margin-bottom: 20px;
}
.email {
display: inline-block;
margin-top: 10px;
padding: 12px 24px;
background: #675dff;
color: #fff;
text-decoration: none;
font-weight: 600;
border-radius: 8px;
transition: background 0.3s ease;
}
.email:hover {
background: #574be0;
}
footer {
margin-top: 40px;
font-size: 14px;
color: #777;
}
</style>
</head>
<body>
<div class=”container”>
<h1>Data Deletion Request</h1>
<p>
At Miropost, we respect your privacy. If you wish to request the deletion of your data from our system,
please contact us by email.
</p>
<a href=”mailto:[email protected]” class=”email”>Request Data Deletion</a>
<p>
We will process your request within <strong>7 business days</strong>.
</p>
<footer>
© 2025 Miropost. All rights reserved.
</footer>
</div>
</body>
</html>

4. Add Facebook Login

In the left sidebar → Add Product.
Choose Facebook Login for Business → Set Up.
Go to Facebook Login → Settings and configure:

Client OAuth Login: YES
Web OAuth Login: YES
Enforce HTTPS: YES
Valid OAuth Redirect URIs:

https://yourdomain.com/app/facebook/profile https://yourdomain.com/app/facebook/page
Data Deletion Request URL:

https://yourdomain.com/delete-data.html

Save changes.

5. Business & Access Verification

Navigate to App Dashboard → Verification:

Business Verification: Upload legal docs, verify domain, confirm phone number.
Access Verification: Required if you are a Tech Provider.

👉 Both must show Verified before requesting advanced access.

6. Request Advanced Access for Permissions

Go to App Review → Permissions and Features and request:

pages_manage_posts → create, edit, delete posts
pages_read_engagement → retrieve likes, comments, shares, insights
pages_show_list → display list of Pages user manages
business_management → manage assets under Business Manager

📌 Notes:

You must successfully test each permission with at least one API call.
Wait up to 24 hours after the first successful call before the Request Advanced Access button appears.

Example test calls:

GET /me/accounts → tests pages_show_list
POST /{page-id}/feed → tests pages_manage_posts

7. Permission Descriptions (for App Review)

pages_manage_posts

Description:
Our app allows users to create, publish, and schedule posts directly to their Facebook Pages from the Stackposts platform. This feature is essential for social media managers and businesses who need to manage multiple Pages efficiently. By granting this permission, the app can automate publishing workflows and ensure posts appear at the correct time on the selected Pages.

Value for user:
Users save time by managing all of their social media content in one place. They can schedule posts in advance, ensure consistent branding, and reduce the risk of missing important publishing deadlines.

Necessity:
Without this permission, the app cannot create or edit content on behalf of the user’s Page, meaning one of the core functionalities (publishing and scheduling posts) would not work.

pages_read_engagement

Description:
Our app retrieves insights and engagement data from Facebook Pages, including likes, comments, shares, and reach metrics for posts. This data is displayed in analytics dashboards inside Stackposts, allowing users to track the performance of their content.

Value for user:
Users gain visibility into how their audience interacts with their content. This helps them identify what types of posts are most effective, optimize future campaigns, and make data-driven decisions to improve engagement.

Necessity:
Without this permission, the app cannot show engagement statistics, which is a core part of the analytics module. This would significantly reduce the usefulness of the app for businesses and marketers.

pages_show_list

Description:
Our app uses this permission to fetch the list of Facebook Pages that a logged-in user manages. The user can then select which Page(s) they want to connect to Stackposts for publishing and analytics.

Value for user:
Users with multiple Pages (e.g., agencies or businesses managing several brands) can easily see all available Pages and connect the ones they want to manage. This improves usability and reduces confusion.

Necessity:
Without this permission, the app cannot know which Pages the user owns or manages, making it impossible to let the user choose a Page to connect.

business_management

Description:
Our app requires this permission to manage Facebook Page assets under the user’s Business account. It ensures that connected Pages, tokens, and assets are correctly assigned to the user’s business for publishing and analytics.

Value for user:
This enables smooth integration with Business Manager accounts, allowing teams and agencies to securely manage multiple Pages and assets in one platform.

Necessity:
Without this permission, the app cannot correctly manage Page assets in Business Manager, which is required for businesses that use multiple admins or handle multiple clients.

8. Record a Demo Video

Meta reviewers require a clear 3–5 minute demo video showing:

Log in to Stackposts with Facebook.
Go to Channels → Add Channel → Facebook → Add Page.
Facebook login popup appears → approve requested permissions.
Page connects successfully in Stackposts.
Create a post → choose Post Now → publish.
Open the Page on Facebook → verify the post.
Show analytics dashboard with likes, comments, reach data.

9. Test with Testers

Go to App Roles → Testers.
Add another Facebook account.
Log in as the tester → connect a Page → publish a test post.

10. Submit App for Review

Go to App Review → Permissions and Features.
Select requested permissions → click Request Advanced Access.
Provide the descriptions (section 7).
Upload demo video (section 8).
Submit.

⏳ Review time: typically 5–10 business days.

11. After Approval

Permissions will switch from Standard Access → Advanced Access.
Set your app to Live Mode.
Real users (not just testers) can connect their Facebook Pages.

Stackposts can now:

✅ Connect Pages
✅ Publish & schedule posts
✅ Retrieve Page analytics

📘 Guide: How to Apply for Tech Provider (Access Verification) on Facebook

To avoid the limitation of 4 apps and to request Advanced Access for permissions (pages_manage_posts, pages_read_engagement, etc.), you must complete Access Verification – Tech Provider.

Below is the step-by-step process:

🔹 Step 1: Complete Business Verification

Go to Business Settings.
Navigate to Business Info → complete the business verification (upload business license, verify domain, company phone number, and email).
Once approved, the status will show Business Verified.

🔹 Step 2: Start Access Verification

Open Meta for Developers → App Dashboard.
Go to Verification → Access Verification section.
Click Start to fill out the form.

🔹 Step 3: Fill in the Access Verification Form

You will see a form like this:

Which options best describe your business?
→ Select SaaS Platform (if you are providing a software-as-a-service product).
How will your business use Platform Data?
→ Write a clear and short explanation, for example:

Our platform helps businesses and individuals manage their social media presence by scheduling posts, publishing content, and analyzing engagement. We use Facebook Platform Data (such as Pages, posts, and insights) only to allow our clients to publish to their Facebook/Instagram accounts and view analytics about their own content. The data is used exclusively to provide these features and is not shared or resold.
Does your business manage multiple business portfolios?
→ Choose No, unless you really manage multiple Business Managers for your clients.
Provide a link to your website
→ Enter your official website URL (e.g., https://miropost.com/). The site must publicly show details about your service/product.

🔹 Step 4: Submit & Wait for Review

After submission, Meta will review your request (usually within 5 business days).
If successful, you will see the status:
“Your business was verified as a Tech Provider.”

🔹 Step 5: Done!

When both Business Verification and Access Verification show as Verified, your business is officially recognized as a Tech Provider.

👉 At this stage:

You are no longer limited to 4 apps.
You can send apps for App Review to request Advanced Access permissions.

You Know Stackposts?

Facebook API Official

📘 Facebook App Setup for Stackposts

1. Prerequisites

2. Create a Facebook App

3. Configure Basic App Settings

4. Add Facebook Login

5. Business & Access Verification

6. Request Advanced Access for Permissions

7. Permission Descriptions (for App Review)

8. Record a Demo Video

9. Test with Testers

10. Submit App for Review

11. After Approval

📘 Guide: How to Apply for Tech Provider (Access Verification) on Facebook

🔹 Step 1: Complete Business Verification

🔹 Step 2: Start Access Verification

🔹 Step 3: Fill in the Access Verification Form

🔹 Step 4: Submit & Wait for Review

🔹 Step 5: Done!

Facebook API Official