Setup OAuth for Instagram

Create your own Instagram OAuth application to use with Filestack.

Create your own Instagram OAuth application

By default, you do not need to configure anything to start uploading files from Instagram, Filestack is ready to go out of the box. When a user logs into his Instagram account from your site, he will authorize Filestack application to access his resources. In order to provide seamless experience to your users you can configure Filestack Custom Auth so that users see your application instead.

This is also a MUST if you are using Custom CNAME with your Filestack application. If this step is not completed prior to using CNAME in a production environment, your users will not be able to access Instagram. Please note that this process requires scope approval from Facebook. Let’s get started!

Create Facebook Application

In order to create Instagram Application it is required to create or use Facebook Application. Please log in to your Facebook developers account and go to My Apps tab on the top right of your screen.

If you already have an application, please choose the one that you would like to use or choose Create App button:

Screenshot showing where to create a Facebook App in Facebbok Dev Account

Set the name for your application and click Create App ID button. Please note, that this Facebook Application name refer to your Facebook app and can differ from your Instagram Application name.

Screenshot showing how to create a Facebbok App ID

Create Instagram Application

Once your Facebook application is created, go to Products tab on the left side of the Dashboard and choose the Instagram from the list of Applications then click Set Up button:

Screenshot showing where to create Instagram App ID

Navigate to Products → Instagram → Basic Display at the left of your Dashboard:

Screenshot showing the path to create Instragram App ID

You shoud now see three section: Basic Display, Permissions and Use Cases and notification section where you will be ask to update the Application Settings. Please add the required settings and click Create New App button at the bottom of the screen.

Screenshot showing the path to create Instragram App ID

You will be requested to create a new Instagram Basic Display Application. Please choose the name for your Instagram Application. Please note that this Application name will be visible by your users during the upload process

Instagram OAuth credentials

Your Instagram App ID and Instagram App Secret key should be now visible. Those keys will need to be set in Filestack Developer Portal.

Screenshot showing Instagram application credentials

Instagram Application settings

Below the Instagram keys you should find three sections for:

  • Client OAuth Settings
  • Deauthorize
  • Data Deletion Requests

Each of the section required specific URL:

  • for Client OAuth Settings please add Valid OAuth Redirect URI

    https://www.filestackapi.com/api/client/instagram/authCallback/open

  • for Deauthorize please add Deauthorize Callback URL:

    https://www.filestackapi.com/api/client/instagram/deauthorize

  • for Data Deletion Requests please add Data Deletion Request URL:

    https://www.filestackapi.com/api/client/instagram/data_deletion

Screenshot showing redirect URL

Verify application

Once this step is completed, please scroll down to the App Review for Instagram Basic Display section, click Add to Submission buttons for both instagram_graph_user_profile and instagram_graph_user_media to grant the permission.

Screenshot showing App review for Instagram

Click the Edit Details for each section.

Screenshot showing App review for Instagram

You will be requested to provide a detailed description of how your application uses the permission or feature requested, how it adds value for a person using your application, and why it's necessary for app functionality. You should also record the step-by-step walkthrought of how your aplication will use this permission. Please learn more about your application review process.

Screenshot showing App review for Instagram

Developer Portal

Once that is done, go back to the Developer Portal Custom Auth configuration and provide your client ID and client secret.

Click save and you are ready to go.

If you have any questions, please contact our friendly Support [email protected]