Skip to main content

Instagram Integration

To connect an Instagram account standalone (without a Facebook Page), create and configure an Instagram app via the Meta for Developers portal.

If you want to connect Instagram through a Facebook Business account instead, follow the Facebook & Instagram integration guide.

note

Only Instagram Professional accounts (Business or Creator) can be connected. Personal Instagram accounts are not supported by the Instagram API.

1. Create a Developer account​

To create an Instagram app, you must first have a Meta developer account. If you don't already have one, go to the Facebook for Developers website and click Get Started in the top right corner. Follow the instructions to sign up for a developer account.

2. Create a new app​

tip

If you already have a Facebook application, we recommend reusing it for Instagram instead of creating a separate app.

Once you have a developer account, go to the Facebook Developer Dashboard and click Create App in the top right corner.

  1. Enter your application’s name and your email address.
  2. Select Content management as the use case filter.
  3. Select Manage messaging & content on Instagram as the use case.
  4. Select your business portfolio.
  5. Review the details and click the Go to dashboard button.
Screenshots:

3. Add permissions​

  1. From the sidebar, click on Use Cases, locate Manage messaging & content on Instagram, and click the Customize button.
  2. Click Add all required permissions.
  3. Click Add permissions and features to add additional permissions.
  4. Add the following permissions:
    • instagram_business_content_publish
    • instagram_business_manage_comments
    • instagram_business_manage_insights
Screenshots:

4. Configure redirect URIs​

  1. On the same page, scroll to the Set up Instagram business login section and click the Set up button.
  2. Add the following Redirect URL and save.
https://example.com/<MIXPOST_CORE_PATH>/callback/instagram_standalone
warning

Replace <MIXPOST_CORE_PATH> with your specified MIXPOST_CORE_PATH. If you have not altered the MIXPOST_CORE_PATH environment variable, use the default value: mixpost.

Note: For the Lite package, use the value mixpost, if this integration is supported in Lite.

Screenshots:

5. Copy the credentials to Mixpost​

On the same page, scroll to the Instagram App ID and Instagram App Secret sections and copy the credentials into the corresponding fields of the Instagram form in Mixpost.

Third-Party Service form's in the Mixpost dashboard

Navigate to the User Menu at the bottom left, click Admin Console, and then click on Services from the left sidebar.

info

The Instagram third-party service is separate from the Facebook service. Make sure to paste the credentials into the Instagram form, not the Facebook form.

Screenshots:

6. Add Instagram testers​

Before the app is published, only users added as Instagram testers can connect their accounts.

6.1 Add tester​

  1. Select App roles -> Roles in the left sidebar.
  2. Click Add people.
  3. Choose Instagram Tester.
  4. Enter the Instagram username of the account you want to test with and send the invite.

6.2 Accept the invitation as a tester​

  1. Log in to the invited Instagram account at instagram.com.
  2. Go to Settings -> Apps and websites -> Tester invites.
  3. Accept the invitation for your app.
Screenshots:

7. Testing and verification​

You can now test by adding your Instagram account to Mixpost. We recommend creating a few test posts to ensure everything is functioning correctly.

How to add a social account

Navigate to a workspace, then select Social Accounts from the left sidebar and click Add Account.

warning

Until your app is published, only Instagram accounts added as testers can connect. To allow any Instagram Professional account to connect, you must submit your app for Meta review and publish it.

8. Configure the Engagement (optional)​

The Engagement brings Instagram comments and mentions into Mixpost's Inbox in real time, delivered through Meta webhooks. Setup has two parts: enable webhooks in Mixpost, then register the callback URL in the Meta dashboard. Once enabled, Mixpost automatically subscribes each connected Instagram account — there is no per-account step in the dashboard.

info

The Engagement must be enabled in your Mixpost installation for the Enable Webhooks switch and the inbox-webhook endpoint to be available.

8.1 Enable webhooks in Mixpost​

  1. Open the Instagram third-party service form in Mixpost (the same form where you pasted the App ID and secret in step 5).
  2. Turn on the Enable Webhooks switch.
  3. In the Webhook Verify Token field, click the generate button (or enter your own random string). Meta sends this value back to Mixpost during the handshake, so keep it handy for the next step.
  4. Save the service.
Third-Party Service form's in the Mixpost dashboard

Navigate to the User Menu at the bottom left, click Admin Console, and then click on Services from the left sidebar.

8.2 Register the callback URL in the Meta dashboard​

  1. From the sidebar, open Use Cases, locate Manage messaging & content on Instagram, click Customize, and open the Webhooks section.
  2. Set the Callback URL to:
https://example.com/<MIXPOST_CORE_PATH>/inbox-webhook/instagram_standalone
  1. Set the Verify token to the exact same value you saved in Mixpost in step 8.1.
  2. Click Verify and save. Meta calls your callback URL to confirm the token matches.
  3. Subscribe to the comments and mentions fields.
warning

Replace <MIXPOST_CORE_PATH> with your specified MIXPOST_CORE_PATH. If you have not altered the MIXPOST_CORE_PATH environment variable, use the default value: mixpost.

Note: For the Lite package, use the value mixpost, if this integration is supported in Lite.

info

Ensure the instagram_business_manage_comments permission (step 3) is added — without it, comment webhooks are not delivered.

note
  • Your App Secret (step 5) validates the signature of every incoming webhook, so no extra credential is needed. The callback URL must be publicly reachable over HTTPS.
  • Mixpost subscribes each account to webhooks when it connects. Accounts added before you enabled webhooks must be reconnected to start receiving engagement.

9. App review​

When you are ready to allow any user to connect their Instagram account, submit the app for review in the App Review -> Requests section and request advanced access for each permission listed in step 3.

On this page