Meta Platforms Setup

Configure Facebook, Instagram, and Threads integrations through the Meta for Developers portal.

IMPORTANT

All three platforms (Facebook, Instagram, Threads) use the same Meta App. You only need one app configured with multiple products.

Use Cases to Select

In your Meta App Dashboard, select these use cases:

Use Case	Purpose
Access the Threads API	Publishing posts to Threads
Manage messaging & content on Instagram	Publishing posts/stories to Instagram
Manage everything on your Page	Publishing to Facebook Pages
Authenticate and request data from users with Facebook Login	Social login for your app

Required Permissions

Social Login (Authentication)

Permission	Purpose
email	Get user's email for account creation
public_profile	Get name, profile picture

Facebook Pages (Publishing + Inbox)

Permission	Purpose
pages_show_list	List pages user manages
pages_read_engagement	Read page insights/analytics
pages_manage_posts	Publish posts to pages
pages_read_user_content	Read comments on your posts
pages_manage_engagement	Reply to comments, like comments
pages_messaging	Read/send Messenger conversations

Instagram (Publishing + Inbox)

Permission	Purpose
instagram_basic	Get Instagram Business/Creator account info
instagram_content_publish	Publish photos/videos/carousels
instagram_manage_insights	Read analytics
instagram_manage_comments	Read/reply to comments
instagram_manage_messages	Read/send Instagram DMs

Threads (Publishing)

Permission	Purpose
threads_basic	Get profile info
threads_content_publish	Publish text/image/video posts
threads_manage_insights	Read analytics
threads_read_replies	Read replies to threads
threads_manage_replies	Reply to threads

Platform Limitations

WARNING

These are platform-imposed limitations, not TendSocial limitations.

Platform	Can Post To	Cannot Post To
Facebook	Pages, Groups	Personal profiles
Instagram	Feed posts, Reels, Carousels	Stories, Personal accounts
Threads	Text, Images, Videos, Replies	(Most features available)

Instagram-Specific Limitations

• Only Business or Creator accounts are supported (not personal accounts)
• Stories cannot be published via API
• DMs are limited to a 24-hour response window for user-initiated messages only

Callback URLs

Configure these URLs in your Meta App settings:

OAuth Redirect URIs

https://api.tendsocial.com/api/social/accounts/callback/facebook_page
https://api.tendsocial.com/api/social/accounts/callback/instagram_business
https://api.tendsocial.com/api/social/accounts/callback/threads
https://api.tendsocial.com/api/auth/facebook/callback

Deauthorize Callback URL

https://api.tendsocial.com/api/webhooks/meta/uninstall

Set this in: App Settings → Basic → Deauthorize Callback URL

Data Deletion Request URL

https://api.tendsocial.com/api/webhooks/meta/delete

Set this in: App Settings → Basic → Data Deletion Request URL

Environment Variables

FACEBOOK_APP_ID=your_app_id
FACEBOOK_APP_SECRET=your_app_secret

App Review

To use these permissions in production with users outside your development team, you must submit for App Review:

1. Create screen recordings demonstrating each permission's use
2. Provide clear privacy policy and terms of service URLs
3. Complete Data Use Checkup
4. Submit Business Verification (for some permissions)

See Meta App Review Documentation for details.

Webhook Verification

Meta verifies webhook endpoints by sending a GET request with:

• hub.mode = subscribe
• hub.verify_token = your configured token
• hub.challenge = string to return

Your endpoint must return hub.challenge to verify ownership.