PROVIDER SETUP DOCS

Integrating with Instagram Graph API

12min

Pathfix allows you to easily add end-user OAuth based integration, handling authorization and enable communication between your app and Instagram Graph API in just a few minutes.

Before proceeding, you will first need to create a Facebook Developer account and add a new application with Facebook for Instagram here: https://developers.facebook.com/apps/

Note: This documentation goes through setup of Instagram Graph setup for business. You will need a Facebook Business account.

Important

If you are working with Facebook and Instagram Graph API, make sure you create a new app for each in Facebook Developer portal



Add your Instagram App on Facebook

The Instagram Graph API app creation contains a few cruicial steps. Please make sure you follow all of the steps outlined here, or else the integration will not work.

Important Note: Facebook developer has gone through some changes, you may see new options for setup if you are creating a new developer app called Usecases. As part of their latest change, you will no longer see a few products as Facebook has merged them into one product or deprecated support.

Please follow the documentation based on the type of developer account and options you see.



Document image




  • Login to your Facebook Developer account and click on Create App
  • Under Usecases, select the usecase as Other
  • Select the app type as None (this allows us to select the Products we need for Instagram)
    • If you do not see None as an option, choose Business



Image: App Type
Image: App Type




  • Fill in the app name and select the Facebook Business account and click on Create App



Image: App Name
Image: App Name




  • If you are seeing the following products, you have the older developer app setting, in which case, add the following 3 Products to your app:
    • Facebook Login
    • Instagram Basic Display
    • Instagram Graph API



Document image




  • For any new developer apps created, add the following 2 products
    • Instagram
    • Facebook Login for Business
  • Select the product Facebook Login, complete the setup process
  • Add the following Pathfix URI under the Valid OAuth Redirect URIs: https://labs.pathfix.com/integrate/command



Document image




  • Click on App settings and select Basic
  • Fill in all the required information, your app domains including pathfix.com as a domain and save the settings
  • Copy the App ID and App secret for use in your Instagram configuration in Pathfix



Document image




Older Apps Only

If you have an older developer app with the Instagram Basic Display and Instagram Graph API products, following the next steps. You can ignore this for newer apps and jump to your Pathfix configuration directly.

  • Next, select the product Instagram Basic Display and complete the setup
  • Add the following Pathfix URI under the Valid OAuth Redirect URIs: https://labs.pathfix.com/integrate/command
  • Add a new Tester for Instagram (make sure you select an Instagram account here)



Document image




  • Next, add Instagram Graph API
  • You will need to approve the request to be added as a Tester to this app, log in to your Instagram account and go Manage Access here: https://www.instagram.com/accounts/manage_access/
  • Click on Tester Invites tab and approve the request from your app



Image: Approve invite
Image: Approve invite




  • On your Facebook developer page, click on Settings and go to Basic
  • Copy the App ID and App Secret for use in Pathfix (IMPORTANT: make sure you copy the App ID and App Secret from the Settings tab only as shown in the image below)



Document image




Setup in Pathfix

  • Login to your Pathfix account and select the application (or you can create a new application)
  • Select Instagram Graph API from the list of providers to integrate with. You can change the Display Name and Description.
  • Enter the App ID and App Secret received from Instagram/Facebook Dev account and hit Save



Image: Configure
Image: Configure




  • Click on Test Connection and Connect an account to test the setup
  • Once connected successfully, you will be able to choose a sample API from the dropdown to run test API calls
  • Select a sample API from the dropdown and click on Send



Document image




Add Integration To Your SaaS

There are 2 steps to adding the integration to your SaaS



To add the integration to your Bubble app, please follow this documentation Bubble.io Setup



Need help? Reach out to us at [email protected] and we would be happy to assist!