API Credentials for Instagram Messaging

Guide to obtaining tokens, keys, and connections.

Connecting to the Instagram API requires completing a series of steps in Meta to obtain an access key. Below is a step-by-step guide explaining how to get it.

Register your Instagram application

1

Go to https://developers.facebook.com
2

Click on 'My Apps'.
3

Click on 'Create App'.
4

In the 'App Name' field, enter a name for your application, for example 'botize'.
5

Click 'Next'.
6

In the 'Add use cases' section, select 'Business Messaging' and then choose 'Manage messaging & content on Instagram'.
7

Click 'Next'.
8

In 'Which business portfolio do you want to connect to this app?' select 'I don't want to connect a business portfolio yet'.
9

Click 'Next'.
10

In 'Publishing requirements', click 'Next'.
11

In 'Overview', click 'Create App'.

Connect your Instagram user

1

Scroll down to the 'App roles' section and click on the 'Roles' subsection.
2

Click the 'Add people' button.
3

Select the 'Instagram Tester' option.
4

In the user search box that appears below, type your Instagram username and select it.
5

Click the 'Add' button.
6

You will be redirected to the 'App roles' table, where your Instagram user will appear with the status 'Pending'.

Accept the connection inside your Instagram application

1

Click the 'Apps and Websites' link that appears in the same row of the table.
2

A new tab will open where you will need to log in with your Instagram account.
3

You will automatically be redirected to the 'Apps and Websites' section.
4

Click on the 'Tester Invites' section.
5

Click the 'Accept' button that appears.
6

Go back to the Meta tab and refresh it. The 'Pending' status will disappear, meaning everything was completed successfully.

Get the Token

1

In the left sidebar, click on 'Use cases'.
2

Inside 'Manage messaging & content on Instagram', click the 'Customize' button.
3

Click the 'Add all required permissions' button.
4

Expand the 'Generate access tokens' section.
5

Click the 'Generate token' link.
6

A window will open asking you to log in with your Instagram account.
7

If you do not yet have a professional account, Instagram will ask you to switch. Click the 'Switch' button.
8

In the permissions section, enable the requested permissions and click the 'Allow' button.
9

Check the 'I understand' box.
10

Click the 'Copy' button to copy the Access Token.
11

Click the 'Done' button to finish.
12

To the right of the 'Generate token' link, enable 'Webhook Subscription' so it is set to 'On'.
13

In the 'Callback URL' field, paste the webhook URL provided by Botize.
14

In the 'Verify Token' field, enter a secret word, for example 'botize'.
15

Click the 'Verify and save' button.
16

Paste your token into the Botize form.

Publish the application

1

As a final step, you may need to complete Meta's app verification process from the 'Review' section in the left sidebar. The requirements and approvals requested by Meta depend on how you plan to use your application and which permissions or features you need, so Botize cannot guide you through the exact verification process.