Instagram Application Setup

Instagram is a hugely popular photo sharing site with over 200 million registered users. Adding authentication for Instagram in Joomla using JFBConnect is a great way to allow new users to register or login to your site. This guide will take you through the full process of creating an Instagram Application.

Before you get started, you will need an Instagram account and a Facebook Application. If you don't already have either, you'll need to create them.

  1. Go to the Facebook Developer Center:
  2. Open your existing app or create a new one following our Facebook Application Setup Guide
  3. In the Product section, add an Instagram product. Instagram Application - Add Product
  4. Click on the 'Basic Display' menu item under the Instagram ProductInstagram Application - Basic Display API
  5. Click 'Create New App' button
  6. Create a new Display Name for your Instagram app (or leave the pre-populated name alone) and click Create App.Instagram Application - Create App
  7. Scroll down and enter the "Valid OAuth Redirect URIs". This is the full root of your Joomla website, including https and index.php. If you have other ways to access your domain (like www or non-www), add them all here, like below (replacing with your actual domain name. Please note that HTTPS is required by Facebook for all Redirect URIs.
  8. "Deauthorize" - Enter the following, replacing wth your actual domain name.
  9. "Data Deletion Requests" - Enter the following, replacing wth your actual domain name.
  10. Once done with steps 7-9, click "Save Changes".
  11. Once you've saved the Instagram settings, please copy and paste the "Instagram App ID" and "Instagram App Secret" to the JFBConnect backend > Configuration > Instagram Area. *Please do not use the Facebook App ID/Secret for your Instagram settings in JFBConnect.
  12. To test the Instagram app in Development Mode, you will need to create an Instagram Test User.
    1. Navigate to Roles > Roles and add an Instagram Tester.Instagram Application - Roles
    2. The Instagram Tester must then login to and accept the Invite on before access will function correctly.
      Instagram Application - Testers
    3. If you forget to add a tester, there will be errors returned from Instagram when you click on the Instagram Login button on your website.
  13. Live Facebook applications must go through the App Review process in order to use the Instagram authentication. You can test in Development Mode with the tester created in step 9 until you're ready to go live.
  14. In order to add the Instagram oEmbed widget with JFBConnect, you'll need to set up the project. Select Products > oEmbed and click on the "Set Up" button. When prompted, confirm the popup.Instagram - oEmbed ProductInstagram - oEmbed Product
  1. Go to the Instagram Developer area:
  2. Click the "Manage Clients" link in the top right.
  3. Click the green "Register a New Client" button in the top right:
    Instagram - Create New Client ID
  4. On the "Register new Client ID" page, fill out the following fields:
    1. Application Name - A short title for your application or site. Your website name is a good suggestion.
    2. Description - A longer description of your site, possibly including why the user may want to register using Instagram.
    3. Company Name - The name of your company
    4. Website URL - The full URL of your homepage.
    5. Valid redirect_uri - The full path to the root of your Joomla website, including http(s) and index.php:
      Please note: If you have a valid SSL certificate installed on your site, you should use the https in the redirect_uri link. In JFBConnect, make sure you enable the "Use SSL For Authentication" setting in the Instagram configuration section.
    6. Privacy Policy URL - URL for a privacy policy on your site.
    7. Contact Email - Email that Instagram can get in touch with you (this is not publicly available).
    8. Your full application setup will look something like:
      Instagram - Application Creation
  5. On the main Instagram Application page, save your Client ID and Secret Key settings to input into JFBConnect:
    Instagram - Client Keys
  6. Submit your Application for Review - Your application will initially be in Sandbox mode. In the Sandbox, only 10 users will be able to authenticate. After that, more users will not be able to login until you go through the review process. To submit your app for review:
    1. Go to the "Permissions" tab in your application. 
    2. In the list for "Which use case best describes your Instagram integration"
      1. choose "My app allows people to login with Instagram and share their own content"
    3. In the "API use Case" area, describe your integration with Instagram. A good example would be:
      "Our site uses Instagram authentication to allow the user to login to our site without having to register a new account"
    4. Video Screencast URL - You must create a video showing the authentication experience on your site using JFBConnect.
    5. Additional Permissions - Do not add any
    6. Once the above is done, click the "Submit" button.
Social Stream
Hide. Seek. Play!

Countdown Hide & Seek Game

Get the new way to play hide & seek! Countdown, the new toy from the founders of SourceCoast, launches this November.

Take care of some holiday shopping early with 20% off and free shipping!

Get Offer

Before You Leave

Let us send you a 10% off coupon

For Your Next Purchase

Please enable the javascript to submit this form

No , I don't want a discount