Skip to content

Instagram Extract authentication guide

This is a step-by-step guide to acquiring third-party credentials for authorizing the Instagram Extract connector for use in Matillion ETL.

This connector uses an OAuth for third-party authentication. OAuth tokens will eventually expire and require remaking. This is outside of Matillion's control. However, existing tokens may be extended or refreshed at any time.

While connector properties may differ between cloud data warehouses, the authentication process remains the same.



  • Instagram uses the Facebook OAuth process for authentication. Therefore, a registered Facebook app must be linked to an Instagram business account.
  • Begin the OAuth entry process as described in Manage OAuth. You should then configure this OAuth entry using your Facebook credentials, obtained as described below.

Acquiring Third-Party Credentials

  1. Navigate to the Facebook Developer Portal (also known as Meta for Developers), click Log In on the top-right of the screen, and enter valid login credentials.

    Log in

  2. Once logged in, the Log In menu option will be replaced by My Apps. Click My Apps to open your Apps page, and then click Create App in the top-right.

    Create app

  3. On the Select an app type page, select the Business type, then click Next.

    Business app

  4. On the Add details page, provide details for the following fields, then click Create App:

    • Display name – provide a name for the app, which will be used to identify it on the Apps page.
    • App contact email – provide a contact email within your organization, to receive notifications and other communications regarding the app.
    • Business account – From the drop-down list, select the business account that the app will be connected to. This is optional so it is normally fine to leave this field showing No Business Account selected, but certain app features will require the app to be connected to a business account.

    Create an app wizard


    You must re-enter your password as a security check before moving on to the next step.

  5. The browser will now show the Add products to your app screen. Locate the Facebook Login product, and click Set Up.

    Set up app

  6. The Quickstart wizard will open. Use this to add Facebook Login to the app. Begin by selecting a platform for the app.

    Selet an app platform

  7. The wizard will reload with a block featuring a series of platform-specific questions and configurations. Follow the prompts and provide the required details. The details will vary depending on which platform you chose in the previous step. For this example, we have chosen Web.

    Web app setup

  8. Next, click on Facebook Login, then Settings on the sidebar to open the Client OAuth Settings dialog. In the Valid OAuth Redirect URIs field, paste the callback (copied from the Manage OAuth dialog in Matillion ETL earlier). Click Save changes in the bottom-right of the dialog.

    Client OAuth settings

  9. Click Add Product next to Products in the sidebar to return to the Add Products to Your App screen. In the list of products available for your app, find Marketing API, and click Set Up. This will take you to the Welcome to Marketing API page, but no further configuration is required here.

  10. Click Settings then Basic on the sidebar and copy the credentials from both the App ID and App Secret fields. These will be required when configuring the OAuth in Matillion ETL in the next step.



    • To copy the App Secret, first click Show and enter your account password when prompted.
    • When copying the credentials, some browsers may add a space to the end of the string. Watch out for this as it will cause the credentials to fail.
  11. Now return to the Manage OAuth dialog in Matillion ETL to complete the OAuth configuration.

  12. When you complete the authorization process in Matillion ETL, you will be directed back to Facebook, where you must complete a few basic steps before the OAuth is fully authorized. When completed, the Facebook page will close and you will return to your METL instance.