Instagram

Prerequisites

Instagram publishing through the API requires:

• A Business or Creator Instagram account
• The Instagram account must be linked to a Facebook Page
• A Facebook Developer app with the Instagram product enabled

Setup

1. Create an app at developers.facebook.com
2. Add the Instagram product to your app
3. Set the Valid OAuth Redirect URI:
   • Production: https://your-domain/api/auth/instagram/callback
   • Local: http://localhost:3847/api/auth/instagram/callback
4. In your Levercast .env.local, set:
   • FACEBOOK_APP_ID
   • FACEBOOK_APP_SECRET
   • FACEBOOK_REDIRECT_URI
5. Navigate to Settings → Connections and click Connect Instagram

Image Requirement

Instagram posts always require an image. Every post must include a publicly accessible image URL. If a user doesn't provide one, Levercast falls back to the INSTAGRAM_DEFAULT_IMAGE_URL environment variable.

INSTAGRAM_DEFAULT_IMAGE_URL=https://your-domain/default-post-image.jpg

What Gets Published

Levercast creates a feed post on your Instagram account with:

• Image — The required photo (from the post editor or default)
• Caption — The AI-generated or manually edited caption text

Default AI Tone

Caption for a feed post. Engaging and visual-storytelling tone. Max 2,200 characters. Use 3–5 relevant hashtags at the end. Can include a short hook and line breaks for readability.

Override this per-account with custom templates.