Skip to main content

Authorization

Follow this guide to create a new Instagram credential that will allow Nexla to authenticate to and exchange data with your Instagram Business account.
insta_api_auth.png

Instagram

Prerequisites​

Before creating an Instagram credential, you need to obtain a System User Access Token from your Facebook Business Suite account. The System User Access Token is required to authenticate with the Instagram API.

To obtain your System User Access Token, you need to have a Facebook Business Suite account with access to Instagram Business accounts. Once you have access to your account, you can create and manage System Users in your Facebook Business Suite settings. System Users are special API users that are designed for programmatic access to Facebook and Instagram resources. The System User Access Token is a Facebook Access Token for a Business Suite System User that has permissions to the Facebook resources you want to access. For detailed information about System Users and access tokens, refer to the Facebook Pages Access Tokens documentation.

Create an Instagram Credential​

  • To create a new Instagram credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Instagram

InstagramCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

System User Access Token Authentication​

Instagram uses System User Access Token authentication to securely access the Instagram API. System Users are special API users designed for programmatic access to Facebook and Instagram resources, providing secure authentication without requiring individual user accounts.

  1. Enter your Facebook System User Access Token in the System User Access Token field. This is the Facebook Access Token for a Business Suite System User that has permissions to the Facebook resources you want to access. The System User Access Token is sent in the Authorization header with the Bearer prefix for all API requests to the Instagram API.

    Keep your System User Access Token secure and do not share it publicly. The System User Access Token provides access to your Instagram Business account data and should be treated as sensitive information. Your Facebook System User Access Token can be found in your Facebook Business Suite account settings where you manage System Users. System Users are special API users designed for programmatic access to Facebook and Instagram resources. The System User Access Token must have permissions to the Facebook resources you want to access. The token is sent in the Authorization: Bearer {token} header for all API requests to the Instagram API. For detailed information about creating and managing System Users and obtaining access tokens, see the Facebook Pages Access Tokens documentation.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.