Korean Medical Tourism Platform

Instagram Business Account Identification

IG Requesting: instagram_basic Permission
Prerequisite for instagram_manage_messages
Back to Index pages_manage_metadata pages_messaging instagram_manage_messages

IG How We Use instagram_basic Permission

What We Do

We retrieve the Instagram Business Account ID linked to our Facebook Page using the Graph API. This ID is essential for all subsequent Instagram operations.

Why It's Necessary

Without instagram_basic, we cannot call GET /{page-id}?fields=instagram_business_account API to identify which Instagram account to manage for DM operations.

Prerequisite Status

This permission is REQUIRED before requesting instagram_manage_messages. It provides the foundation for all Instagram DM functionality.

Permission Dependency Chain
1
pages_manage_metadata
(Standard)
->
2
pages_messaging
(Advanced)
->
3
instagram_basic
(Advanced)
->
4
instagram_manage_messages
(Advanced)

Demo Live Demo: Get Instagram Business Account Info

1
Authenticate with Facebook

Permissions requested: pages_show_list, pages_manage_metadata, instagram_basic

Review Instructions for Meta Reviewers

1
Click "Login with Facebook" button above to authenticate with your test account. You will be prompted to grant instagram_basic permission.
2
After login, locate "Step 2: Get Instagram Business Account Info" section. The system will automatically detect your Facebook Pages.
3
Click "Get Instagram Account Info" button. This will call GET /{page-id}?fields=instagram_business_account API.
4
Verify the results. You should see:
  • Instagram User ID (e.g., 17841472534595863)
  • Username (e.g., @alllitingpsjpn)
  • Account Type: BUSINESS
  • Profile picture (if available)
5
Success criteria: The Instagram Business Account ID is successfully retrieved and displayed. This ID will be used for DM operations with instagram_manage_messages.

Technical Information

API Endpoint: GET /{page-id}?fields=instagram_business_account
Required Permission: instagram_basic (Advanced Access)
Graph API Version: v21.0

Response Example:
{
  "instagram_business_account": {
    "id": "17841472534595863",
    "username": "alllitingpsjpn"
  },
  "id": "123456789"  // Page ID
}

Business Purpose:
- Identify Instagram Business Account linked to Facebook Page
- Retrieve IG User ID for subsequent DM operations
- This is a PREREQUISITE for instagram_manage_messages