Storydump
Back to home

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.

Meta's developer portal changes frequently. If a screenshot doesn't match exactly, look for similar options nearby.
1

Create a Meta Developer account

Go to https://developers.facebook.com and log in with the Facebook account linked to your Instagram.

  1. Click "Get Started" or "Register"
  2. Accept the developer terms
  3. Verify your account if prompted
You should see: Meta Developer registration page
2

Create a new App

  1. Go to My Apps → Create App
  2. App type: Business (not Consumer, not None)
  3. App name: anything you like (e.g., "Storydump" or "My Story Bot")
  4. App contact email: your email address
  5. Business portfolio: create one or use an existing one
You should see: Create App dialog with Business type selected
3

Add Instagram Graph API product

From your App Dashboard:

  1. Click Add Product in the sidebar
  2. Find Instagram Graph API
  3. Click Set Up
You should see: Add Product — Instagram Graph API
4

Configure Instagram Basic Display (if needed)

Some flows also require the Basic Display API. Add it the same way:

  1. Add Product → Instagram Basic Display → Set Up
You should see: Instagram Basic Display setup
5

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 info
  • instagram_content_publish — post Stories
  • pages_show_list — list connected Pages
  • pages_read_engagement — read Page info
You should see: Graph API Explorer with required scopes
6

App Review (the hard part)

This is the most time-consuming step. Meta reviews your app before granting publishing permissions. This can take 1-5 business days.

To submit for review:

  1. Go to App Review → Permissions and Features
  2. Request instagram_content_publish
  3. Prepare a short screencast (< 2 minutes) showing how your app uses the Instagram API
  4. Write a description of your use case
  5. 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
If you only plan to use Storydump for your own account(s), Development Mode is sufficient — you don't strictly need App Review. But it's recommended for stability.

While waiting for approval, you can proceed with Google Drive setup and media organization.

7

Get your App credentials

From your App Dashboard:

  1. Go to Settings → Basic
  2. Copy your App ID and App Secret
  3. You'll enter these during Storydump's Telegram setup
You should see: App Settings showing App ID and App Secret
The App Secret is like a password. Never share it publicly or commit it to Git.
8

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.