Instagram App Setup (with Instagram Basic Display API)


This document provides instructions on how to set up the Instagram extension and allows users to show their Instagram photos on their profile page.

Note: Starting October 15, 2019, new client registration and permission review on Instagram API platform are discontinued in favor of the Instagram Basic Display API. If you registered your application before October 15, you should use Instagram API. See instruction Instagram App Setup.


Instagram App creation and setup  #

You have to create a Facebook App to use Ultimate Member Instagram extension.
The application can work in one of these modes:

Facebook App is in the Development Mode by default. You have to request permissions and go through App Review to enable Live Mode.

Step 1: Create a Facebook App

Go to, click My Apps, and create a new app. Once you have created the app and are in the App Dashboard, navigate to [Settings > Basic], scroll to the bottom of the page, and click Add Platform.

Choose Website, add your website’s URL, and save your changes

Step 2: Configure Instagram Basic Display

Go to Dashboard, scroll down, locate the Instagram product, and click Set Up to add it to your app.

Click Basic Display, scroll to the bottom of the page, then click Create New App.

In the form that appears, complete each section using the guidelines below.

Step 3: Add an Instagram Test User

Navigate to [Roles > Roles] and scroll down to the Instagram Testers section. Click Add Instagram Testers, enter your Instagram account’s username and send the invitation.

Open a new web browser and go to and sign in to your Instagram account that you just invited. Navigate to [Profile > Edit Profile > Authorized Applications > Tester Invites] and accept the invitation.

Your Instagram account is eligible to be accessed by your Facebook app while it is in Development Mode.

Note: All permissions need to be approved for your app through the App Review process before they can be used in Live Mode

Configure extension`s settings  #

Go to the extensions' settings page [Ultimate Member > Settings > Extensions > Instagram Photos], enable the extension, select API type and paste API keys using the guidelines below.

  • Enable Instagram Photos - Enable extension
  • Instagram API type - select "Instagram Basic Display API"
  • App ID - paste your Instagram App ID displayed in [App Dashboard > Products > Instagram > Basic Display].
  • App Secret - paste your Instagram App Secret displayed in [App Dashboard > Products > Instagram > Basic Display].

[Ultimate Member > Settings > Extensions > Instagram Photos]

[App Dashboard >Products > Instagram Basic Display> Basic Display]

Add Instagram Photos to Profile form  #

Once you have created the Instagram app and copied App ID and App Secret, add the Instagram Photos field to the member's profile:

  • Go to the Profile form builder [Ultimate Member > Forms]
  • Add new or edit existing Profile form
  • Click the + icon to add a new field
  • Select the Instagram Photos field
  • Give the field a title and configure other options
  • Save field and form

[Ultimate Member > Forms > Profile form]

[Ultimate Member > Forms > Profile form, Fields Manager]

[Ultimate Member > Forms > Profile form, Instagram Photos field]

Connect the profile to Instagram #

Once the Instagram Photos field is added to the Profile form, members can connect their accounts to Instagram using the guidelines below.

  • Go to profile and enable Edit profile mode
  • Click the Connect to Instagram link
  • Authenticate your Instagram user by signing into the Authorization Window, then click Authorize to grant your app access to your profile data. Upon success, the page will redirect you to your profile.
  • Click the Update Profile button to save the access token.


[Profile > Edit profile]

[Instagram Authorization Window]


Note: Instagram User access tokens are limited by time. Short-lived access tokens are valid for 1 hour. Long-lived access tokens are valid for 60 days. The extension updates the token automatically if the profile owner visits the Profile page. The profile owner can renew expired tokens manually - click the link "Update" and reconnect.

App Review & Live Mode  #

Before you can switch your app to Live Mode, you may have to go through App Review. The process allows Facebook to verify who you are and how you will use the data your app will access.


Data access authorization is controlled by your app users through the permissions listed below. Users must grant their app these permissions through the Authorization Window before their app can access their data.

Note: All permissions need to be approved for your app through the App Review process before they can be used in Live Mode

Individual Verification

You'll need to provide an email address where you can receive, review, and submit a contract and upload an image copy of an approved ID or document. By verifying as an individual, certain permissions or Features from your request may not be available or will be limited per each app installer. You'll also need to sign one contract. Lean more

Errors  #

Error "Insufficient developer role" may appear if Facebook App is in the Development Mode and you are not a Tester. You have to make yourself a Tester or enable Live Mode.

Error " The access_token provided is invalid." may appear if the access token is older than 60 days. Try to reconnect.