Connecting Instagram

Caution

Preview — upload support isn’t final yet. These docs describe the intended v1 experience. If you’re reading this ahead of launch, expect rough edges and verify uploads carefully.

Note

Before you can connect Instagram, you need a Meta developer app with instagram_content_publish access, and an Instagram Business or Creator account linked to a Facebook Page. If you haven’t set those up yet, follow the Instagram (Meta) setup guide first.

Connecting

1. Open Settings → Instagram.
2. Click Connect Instagram.
3. A browser window opens asking you to sign in to Facebook.
4. Review the permissions — the app requests:
   • Access basic profile info (instagram_basic)
   • Publish content on your behalf (instagram_content_publish)
   • Show a list of your Pages (pages_show_list)
   • Read Page engagement (pages_read_engagement)
5. Pick the Facebook Page that’s linked to your Instagram Business or Creator account.
6. Click Authorize.

The browser redirects back to the app and shows Connected.

What gets saved

A long-lived Page access token plus your Instagram Business Account ID is stored locally at .instagram_token.json inside the app data directory. Nothing is sent anywhere except Meta’s Graph API during uploads.

Tokens last roughly 60 days. When one expires, clicking Connect Instagram again refreshes it without any extra setup.

Upload settings

Below the connect button you can configure:

• Clip Duration (seconds) — how long the Reel clip is. Default is 60. Meta’s current Reel limit is 90 seconds.
• End Card Text — overlay text shown on the last few seconds of the clip. Default: Full video on YouTube.
• Caption Template — the caption used on every post. Supports {title} (song title) and {channel} (your channel name). Example: {title} - Full video on YouTube #music #newmusic.
• Share to Feed — when on, the Reel also appears on your main Instagram grid. When off, it’s only in the Reels tab.

Disconnecting

Click Disconnect Instagram. The stored token is removed. Reels you’ve already uploaded stay on Instagram — disconnecting only revokes the local token, not the app’s Meta-side authorization. To fully revoke access, go to Instagram → Settings → Apps and Websites and remove the app there too.

Troubleshooting

“No Instagram Business Account linked to any Page” error during connect. Your Instagram account is either still a personal account or it’s not linked to a Facebook Page. Fix both in order:

1. In the Instagram app, go to Settings → Account type and tools and switch to Business or Creator.
2. On the Facebook Page you want to use, open Settings → Linked accounts → Instagram and link your IG account.
3. Back in AI Music Video Generator, click Connect Instagram again.

The Meta sign-in screen doesn’t list your Page. Only Pages that your Facebook account is an admin of show up. If the Page is owned by someone else (an agency, a band member), ask them to add you as an admin under the Page’s Settings → Page roles.

Reel publishes but is stuck processing on Instagram. Instagram processes Reels server-side after upload. Very short clips (< 3s) or very long ones (> 90s) can be rejected silently. Try a 15–60 second clip.

For more, see Upload troubleshooting.