⚠️

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.

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.

Step 1

Create a new app in Instagram developers, choose the business you want to connect it to.
Please be advised that for public applications you would need to verify you business.

Create app

Step 2

Select “Other” and click next

Other

Step 3

Then select business

Business

Add all your details and click Create App

Step 4

CleanShot 2024-09-24 at 13 45 54

Set final details

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.

Set up Login for Business

Setup Login with Instagram

Set up login for business

Set up Redirect URI

Set up a redirect URI back to the application Instagram


The OAuth2 Redirect URI is the location where the provider will redirect to after trying to login. This needs to set to your Postiz FRONTEND_URL + /integrations/social/ + instagram.

  • eg: If you are running on a container, and your Postiz URL is: https://postiz.example.com, then your OAuth2 Redirect URI is https://postiz.example.com/integrations/social/instagram
  • eg: If you are running on localhost, and your Postiz URL is http://localhost:4200, then your OAuth2 Redirect URI is http://localhost:4200/integrations/social/instagram

You only need to set one OAuth2 Redirect URI when you are setting up your Postiz app.

Set up permissions

step 7

Go 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

Copy App ID and Secret

Keys

Go 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.

Set up Instagram

Instagram

Set up Instagram.

Set up Instagram Business Login

Set up Instagram Business Login

Click on the button to set up Instagram Business Login

Set up Redirect URI

Set up redirect URI


The OAuth2 Redirect URI is the location where the provider will redirect to after trying to login. This needs to set to your Postiz FRONTEND_URL + /integrations/social/ + instagram-standalone.

  • eg: If you are running on a container, and your Postiz URL is: https://postiz.example.com, then your OAuth2 Redirect URI is https://postiz.example.com/integrations/social/instagram-standalone
  • eg: If you are running on localhost, and your Postiz URL is http://localhost:4200, then your OAuth2 Redirect URI is http://localhost:4200/integrations/social/instagram-standalone

You only need to set one OAuth2 Redirect URI when you are setting up your Postiz app.

Copy Instagram App ID and Secret

Instagram App ID and Secret

From 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"

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.