Skip to content
AI Music Video Generator

Instagram (Meta) setup

To upload Reels to Instagram from the app, you need a Meta developer app with the right permissions and an Instagram Business or Creator account linked to a Facebook Page. This is a one-time setup.

Before you start

Make sure all three are true:

  • You have an Instagram Business or Creator account (not a personal account). You can switch an existing personal account in the Instagram app under Settings → Account type and tools.
  • You have a Facebook Page that is linked to your Instagram account. In the Facebook Page’s settings, go to Linked accounts → Instagram and connect it.
  • You have a Facebook account you can use to log in to the Meta developer portal.

1. Register as a Meta developer

Go to developers.facebook.com and log in with your Facebook account. Complete the developer registration if prompted.

2. Create a Meta app

  1. In the dashboard, click My Apps → Create App.
  2. Choose the Business use case.
  3. Fill in the app details:
    • App name: AI Music Video Generator
    • App contact email: your email
  4. Click Create app.

3. Add the Instagram product

  1. On your app’s dashboard, find Add products to your app.
  2. Click Set up on Instagram.
  3. Choose Instagram Graph API (for posting to Business/Creator accounts via a Facebook Page).

4. Request the required permissions

Under App Review → Permissions and Features, request access to all four:

  • instagram_basic
  • instagram_content_publish
  • pages_show_list
  • pages_read_engagement

Meta reviews instagram_content_publish manually. You’ll need to provide:

  • A screencast showing the app publishing a Reel on your behalf.
  • A short description of what the app does (a desktop music-video generator that posts Reels to your own account).
  • A privacy policy URL (a simple GitHub README or static page is fine).

Expect several days for a response.

5. Set the OAuth redirect

  1. Open Facebook Login → Settings in your Meta app.
  2. Under Valid OAuth Redirect URIs, add http://127.0.0.1/ (with the trailing slash).
  3. Save.

The app spins up a temporary local server on a random port during sign-in, so the exact port doesn’t need to be listed.

6. Copy the App ID and App Secret

On your app’s App settings → Basic page:

  • Copy the App ID — a long number, e.g. 1234567890123456.
  • Click Show next to App Secret, enter your Facebook password, and copy the secret.

Copying Meta App credentials

7. Add the credentials to AI Music Video Generator

Instagram credentials live in your config.json (the App Secret is not shown in the app UI by design). Open the file:

  • macOS: ~/Library/Application Support/MusicVideoGenerator/config.json
  • Windows: %APPDATA%\MusicVideoGenerator\config.json

Add (or merge into) an instagram block with your values:

{
  "instagram": {
    "app_id": "1234567890123456",
    "app_secret": "your-app-secret-here"
  }
}

Save the file and restart the app.

8. Connect your account

In the app, go to Settings → Instagram and click Connect Instagram. The browser opens a Meta sign-in flow, asks you to approve the four permissions, and drops you back into the app with a Connected status.

See Connecting Instagram for the rest of the flow and troubleshooting.

Notes

  • Development mode is fine for personal use. While your app is in Meta’s development mode, only accounts you add as Testers in the Meta dashboard can authorize it. If you’re only posting to your own account, add yourself as a tester and you never have to submit for review.
  • Public release requires app review. If you want anyone else to connect, submit the app for review with the instagram_content_publish permission.
  • Tokens last ~60 days. The app swaps the short-lived user token for a long-lived Page access token automatically and reuses it until it expires, at which point you’ll be prompted to reconnect.