> For the complete documentation index, see [llms.txt](https://docs.novaworks.net/kitify/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.novaworks.net/kitify/api/how-to-get-instagram-access-token.md).

# How to get Instagram Access Token

Starting from **March 2020**, Facebook requires users to create a Facebook app with Instagram Basic Display API to get a long-live Instagram Access Token. Follow our instructions on this section to get your own Instagram Access Token and paste it back on the **Appearance ▸ Customizing ▸ API keys ▸ Instagram Access Token**

You will need:

* A Facebook account.
* An Instagram account with media.

## Step 1: Create App

Go to [developers.facebook.com](https://developers.facebook.com/), click My Apps, and create a new app.

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2Fo0e6kxPb9VRarwVwirlK%2F7527145298.png?alt=media\&token=0db27a0e-dabf-48f1-818a-065a00b6e795)![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FkhHOmT4BCg1aiWhThQ1M%2F3963619675.png?alt=media\&token=f719d632-23fb-4259-873d-a89f898f74b2)

Once you have created the app and are in the App Dashboard, navigate to Settings > Basic, scroll the bottom of the page, and click Add Platform.

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FioRyCZ4TMBt2M1ggdUDZ%2F3.png?alt=media\&token=1bd7fb9f-f51a-4e2f-81db-ff0a3c985f4a)

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

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2F7wiqAR8utUfp13uJVljF%2F4.png?alt=media\&token=dd6be12f-dcac-47b7-81a8-d42e88b6352d)

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FDJUitdsCdv7UmOLXRBfC%2F5.png?alt=media\&token=fb4e8081-cb89-4ca0-9fb4-ce0f521aff7a)

## **Step 2: Configure Instagram Basic Display**

Click **Products**, locate the **Instagram** product, and click **Set Up** to add it to your app.

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FQv6C5M1LT3qfY2Vdb8BZ%2F6.png?alt=media\&token=a1f0256b-6760-4505-9150-31234807c969)

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

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FmvPiDCsKI768zwCWPFri%2F7.png?alt=media\&token=a39c1bc9-4d9e-43c6-b409-91fd7e5415f6)

In the form that appears, complete each section using the guidelines below.\
***Display Name***\
Enter the name of the Facebook app you just created.

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FoFeCmq6I2fYqwhTSaEhc%2F8.png?alt=media\&token=acbd3469-87cb-4c71-9434-269b69d07614)

***Valid OAuth Redirect URIs***

Enter your website’s URL.

For example: <https://novaworks.net/>

After you enter a URL, save your changes and check the URL again; Instagram may have appended a trailing forward slash depending on your URL structure.

***Deauthorize Callback URL***

Enter your website’s URL again.

***Data Deletion Request Callback URL***

Enter your website’s URL once again.

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FfMAK09lnXh0d7FemVtQ5%2F9.png?alt=media\&token=b39bcfb1-c8d8-4097-b654-aed7ad12867c)

#### App Review

Skip this section for now since you will not be switching the app to Live Mode during the tutorial.

Save your changes before heading to the next step.<br>

## **Step 3: Add an Instagram Test User**

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

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FzhTRrWxFZxKLZTMf2mME%2F10.png?alt=media\&token=f441ea6d-e741-49b8-aac2-766e3ee0540d)

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FZhuDsGPNGaxZdZFZtSVV%2F11.png?alt=media\&token=55f28754-c0ac-4cce-964b-7cd06cc07c23)

Open a new web browser and go to [www.instagram.com](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.instagram.com%2F\&h=AT3IpFSLdh5MMecvubFoSiffDnOhipinduFlVQEukLk8fH553_YldBY9hlCWjLXyqVPYOBc6r4J7QjpF-q9Ys1RUW64vHJQlFdq8WjVDluEBjJf-rh-qsD1QNxXUiZuthm82NTKAIZjyCFL24-lQHw) and sign in to your Instagram account that you just invited. Navigate to (Profile Icon) > Click on the **cogwheel** icon next to **“Edit Profile”** button > **Apps** and **Websites** > **Tester** Invites and accept the invitation.

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FksNF7HyjbmZN1p8RAyqr%2F12.png?alt=media\&token=e881ed83-111c-453d-b166-57c4ef0916bd)

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FKeNhqMet6rzH8Yqv8jxE%2F13.png?alt=media\&token=ca215ef6-8a96-4311-9931-fba75439ac53)

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

## **Step 4: Generate Access Token for Test User**

Navigate to **App Dashboard** > **Products** > **Instagram** > **Basic Display** page and scroll down to **User Token Generator** section. Click on **“Generate Token”** button.

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FgHAvSUCenKT5aVCPcRCs%2F14.png?alt=media\&token=8e5d5e45-5b56-4a07-818b-abba4b7aeea7)

Log in with your Instagram account. Allow the app to access your Instagram account data

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FLIDwokvVLePd6mEDspI6%2F15.png?alt=media\&token=74c313db-4e92-4792-b3ef-33df60de1b68)

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2Fp2TB5eX3g7LSmyag9xPl%2F16.png?alt=media\&token=52d0d3a8-4c91-482a-b2b5-c3ddce2f4332)

Click on “I understand” checkbox then copy your Instagram Access Token.

![](https://2156368590-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiZOO5vSmo57bkwUb5p8O%2Fuploads%2FABZxB9lkldcwDcIAgutI%2F17.png?alt=media\&token=c10fa1b3-ad3d-47f4-baf7-40757333b00e)

## Step 5: Add Token to your site

Paste your Instagram Access **Token on  Appearance ▸ Customizing ▸ API keys ▸ Instagram Access Token**<br>