Skip to main content

​
Prerequisites

If you choose to create a custom OAuth application in the Meta Developer Portal (optional), follow these steps:
Before you begin, make sure your Instagram account is a Business or Creator account that is connected to a Facebook Page. You must have a role on the Page that is associated with the Instagram account.
1
Go to the Meta Developer Portal. Sign in with your Facebook account (or create one if you do not already have one).
2
Register the application.
  • Click Create App and follow the prompts to create a new app.
  • After the app is created, go to Settings > Basic. The App ID and App Secret shown here are the values you will enter as the OAuth Client Id and OAuth Client Secret in the setup steps below.
  • Click Add Platform and select Website. Enter a Site URL for your application.
3
Add and configure the Facebook Login product.
  • From the left navigation, click Add Product and add Facebook Login.
  • Under Facebook Login > Settings, in Valid OAuth Redirect URIs, enter the redirect URI used by Connect AI: https://oauth.cdata.com/oauth/.
  • Save your changes.
4
Add the Instagram product.
  • From the left navigation, click Add Product and add Instagram.
5
Submit your app for review.
  • Click App Review > Permissions and Features, then click Request Advanced Access for the following permissions: instagram_basic, instagram_manage_comments, and instagram_manage_insights.
  • Provide the information Meta requires and submit the request. You must wait for Meta to approve the permissions before you can use the custom OAuth app to connect production Instagram accounts.

​
Setup Guide

Follow these steps to connect Instagram to your Connect AI account:
1
Open the Sources page of the Connect AI navigation menu.
2
Click + Add Connection in the upper-right corner.
3
Type Instagram into the search field, then click the data source name.
4
On the Basic Settings tab of the new connection, enter a connection name or keep the default name.
5
(Optional) Enter a Business Account Id. This is only required if you have more than one Instagram business account associated with one Facebook Account.
6
(Optional) If you are using a custom OAuth application to connect, click Advanced Settings and enter the OAuth Client Id and OAuth Client Secret obtained from the prerequisites.
7
Click Sign in to connect securely through OAuth. This action opens the Instagram sign-in page in a new tab.
8
Log in to your Instagram account and provide the requested permissions (if applicable).
9
At the top of the Connect AI Add Connection page, click Save & Test.
  • If the connection test succeeds, a Connection successfully saved message appears, indicating that your connection has been created. The Status on the Edit Connection page also changes to Authenticated. View the data model of your successful connection in the right pane of the Edit Connection page, in the Data Model tab.
  • If the connection test fails, ensure that you entered your login information correctly with no stray spaces or other characters. Connect AI displays error messages under the required fields with missing data. Some data sources require that you sign in directly to the source website. If you did not, an error message appears under the Sign in button. Correct the errors and try again.
  • Unsuccessful connections are saved as drafts and have a Status of Not Authenticated. You can return to the connection and authenticate it later.

​
More Information

For more information about interactions between Connect AI and Instagram, see this information page.