Skip to main content
NOTE: Please be advised that Instagram and Facebook can use the same app (no need to create two separate apps)

​
Connection Options

There are two ways to connect to an Instagram account: by using a Facebook Business or through a standalone flow that connects directly to an Instagram account. Both methods will require a Meta for Developers account.

​
Setting up Meta Application

The following steps will guide you through the setup of a Meta application that can be used for connecting Instagram to Postiz.
1

Create a new app

Select a business portfolio, then create a new app in Meta for developers.Please be advised that for public applications, you will need to verify your business.Business PortfolioCreate app
2

Select app type

Select “Other” and click nextOther app use cases
3

Select business

Then select businessBusiness
4

Add details and create app

Add all your details and click Create AppCreate an app details page

​
Facebook Business Option

If you have a Facebook Business page that is linked to your Instagram account, you can connect to it by setting up the Login for Business flow.
1

Set up Login for Business

Setup Login with InstagramSet up login for business
2

Set up Redirect URI

Set up a redirect URI back to the applicationInstagramYour Instagram OAuth2 Redirect URI:
  • Production: https://your-postiz-domain.com/integrations/social/instagram
  • Local development: http://localhost:4200/integrations/social/instagram
  • Docker: http://localhost:5000/integrations/social/instagram
3

Set up permissions

step 7Go to advanced permission and request access for the following scopes:
  • instagram_basic
  • pages_show_list
  • pages_read_engagement
  • business_management
  • instagram_content_publish
  • instagram_manage_comments
  • instagram_manage_insights
4

Copy your credentials

KeysGo to basic permissions copy your App ID and App Secret and paste them in your .env file
FACEBOOK_APP_ID="app id"
FACEBOOK_APP_SECRET="app secret"
Instagram should now be working!

​
Instagram Standalone Option

If you want to connect directly to your Instagram account without having to use a Facebook Business, use the standalone option.
Please note that standalone option requires a professional Instagram account.
1

Set up Instagram

"Add products to your app" section of app creationSet up Instagram.
2

Set up Instagram Business Login

Set up Instagram Business LoginClick on the button to set up Instagram Business Login
3

Set up Redirect URI

Set up redirect URIYour Instagram Standalone OAuth2 Redirect URI:
  • Production: https://your-postiz-domain.com/integrations/social/instagram-standalone
  • Local development: http://localhost:4200/integrations/social/instagram-standalone
  • Docker: http://localhost:5000/integrations/social/instagram-standalone
4

Copy Instagram App ID and Secret

Instagram App ID and SecretFrom your Instagram API setup screen copy the Instagram App ID and Instagram App Secret and paste them in your .env file
INSTAGRAM_APP_ID="app id"
INSTAGRAM_APP_SECRET="app secret"
5

Add Instagram Standalone channel in Postiz Application

Go to the Postiz web interface, and click on the “Add Channel” button. Select “Instagram (Standalone)” from the list of available channels. You should be redirected to the Instagram login screen to authorize the application.

​
Adding App Roles

If you’re having trouble connecting to your Instagram accounts, adding them as App Roles may help.
1

Go to the App Roles page

Facebook App developers dashboard
2

Add a role

Click on “Add People”App Roles page
3

Add an Instagram Tester

Select the “Instagram Tester” option, and type in the handles of all the Instagram accounts you’d like to connect to. Then, click “Add”.Add people window
4

Accept the invitations

Go to your Instagram account, and accept the tester invitation in the Apps and Websites section of the profile settings.Apps and Websites section of the profile settings