Meta Developer App Setup
This is the most involved step. You'll create a Meta App with the right permissions for Instagram Story publishing. Meta's developer portal can be confusing — follow each step carefully.
Create a Meta Developer account
Go to https://developers.facebook.com and log in with the Facebook account linked to your Instagram.
- Click "Get Started" or "Register"
- Accept the developer terms
- Verify your account if prompted
Create a new App
- Go to My Apps → Create App
- App type: Business (not Consumer, not None)
- App name: anything you like (e.g., "Storydump" or "My Story Bot")
- App contact email: your email address
- Business portfolio: create one or use an existing one
Add Instagram Graph API product
From your App Dashboard:
- Click Add Product in the sidebar
- Find Instagram Graph API
- Click Set Up
Configure Instagram Basic Display (if needed)
Some flows also require the Basic Display API. Add it the same way:
- Add Product → Instagram Basic Display → Set Up
Generate an access token
Storydump handles OAuth for you during the Telegram setup wizard, so your app just needs the right permissions configured. The required scopes are:
instagram_basic— read account infoinstagram_content_publish— post Storiespages_show_list— list connected Pagespages_read_engagement— read Page info
App Review (the hard part)
To submit for review:
- Go to App Review → Permissions and Features
- Request
instagram_content_publish - Prepare a short screencast (< 2 minutes) showing how your app uses the Instagram API
- Write a description of your use case
- Provide a privacy policy URL (a simple page on your site works)
Tips for faster approval:
- Keep the screencast short and focused
- Show the exact flow: content selection → scheduling → publishing
- Emphasize that content is user-owned and approved before posting
While waiting for approval, you can proceed with Google Drive setup and media organization.
Get your App credentials
From your App Dashboard:
- Go to Settings → Basic
- Copy your App ID and App Secret
- You'll enter these during Storydump's Telegram setup
Common issues
"My app is in Development mode"
That's fine for personal use with up to 5 test users. Add your Instagram account as a test user in the App Dashboard.
"I don't see instagram_content_publish"
Make sure your app type is set to Business. Consumer and None app types don't have access to publishing permissions.
"App Review was rejected"
Review the rejection reason carefully. Common issues include incomplete screencasts, missing privacy policy, or unclear use case descriptions. You can resubmit after addressing the feedback.
"Token expires after 60 days"
Storydump handles token auto-refresh automatically. You don't need to manually renew tokens.
Need help? christophertrogers37@gmail.com