Instagram Graph API Getting Started: Setup & First Request (2026)

Getting started overview

Integrating with the Instagram Graph API requires a structured approach, beginning with establishing a developer presence within the Meta ecosystem. The process involves creating a Facebook Developer account, setting up a new Facebook App, and configuring it to support Instagram Graph API functionality. A key step is obtaining user access tokens, which authenticate requests and grant necessary permissions to access Instagram business accounts. This guide outlines the essential steps from initial setup to executing your first API request, enabling programmatic interaction with Instagram content and data.

The Instagram Graph API is designed for businesses and third-party platforms to manage their Instagram presence at scale. It facilitates actions such as publishing media, moderate comments, and accessing performance insights for Instagram business and creator accounts. Access to specific features and data is contingent on the permissions granted to your Facebook App and the type of access token used. Understanding the Instagram Graph API overview is foundational before proceeding with implementation.

Create an account and get keys

To begin using the Instagram Graph API, you must first set up a developer environment within Meta's platform. This involves several distinct steps to ensure your application has the necessary credentials and permissions.

1. Create a Facebook Developer Account

If you don't already have one, create a Facebook Developer account. This account serves as your primary identity within the Meta developer ecosystem and is required to create and manage Facebook Apps.

2. Create a New Facebook App

Once your developer account is active, navigate to the Apps dashboard and create a new app. Select the 'Business' type for your app, as this is typically required for Instagram Graph API integrations. During app creation, you'll be prompted to provide basic information about your app.

3. Add Instagram Product to Your App

After creating your Facebook App, go to the App Dashboard. On the left-hand navigation, under the 'Products' section, click 'Add Product'. Select 'Instagram Graph API' from the list of available products and follow the prompts to add it to your app. This step integrates the necessary Instagram functionalities into your Facebook App.

4. Configure Instagram Basic Display (Optional but Recommended)

While the Instagram Graph API is distinct from the Instagram Basic Display API, some initial setup steps for linking Instagram accounts may involve configuring Basic Display. For comprehensive access to user accounts, you may need to register your app for Instagram Basic Display as well, which can simplify the process of obtaining long-lived access tokens for users.

5. Obtain an Access Token

Access tokens are crucial for authenticating your API requests. For Instagram Graph API, you will typically need a user access token. This token is associated with a specific Instagram business account or creator account and determines the permissions your app has. The process usually involves:

• Authorizing a User: Directing an Instagram user (who owns or manages the target Instagram business account) to a specific URL to grant your app permissions.
• Exchanging for a Short-Lived Token: Upon successful authorization, you will receive a short-lived access token.
• Exchanging for a Long-Lived Token: It is recommended to exchange the short-lived token for a long-lived access token, which typically lasts for 60 days, reducing the frequency of re-authentication.

For development and testing, you can use the Graph API Explorer to generate short-lived access tokens and test endpoints without writing code immediately.

Your first request

Once you have a valid user access token for an Instagram business account, you can make your first API request. This example demonstrates how to retrieve basic information about an Instagram user's profile.

Prerequisites:

• A Facebook Developer account and Facebook App with the Instagram Graph API product added.
• A user access token with the instagram_basic permission, linked to an Instagram Business Account.
• The Instagram User ID of the business account you wish to query. You can obtain this by querying /me/accounts on the Graph API with the user's Facebook Page access token, then finding the instagram_business_account field.

Example: Get an Instagram User's Profile

This request fetches the username and media count for a given Instagram business account. Replace {instagram-user-id} with the actual ID and {access-token} with your valid user access token.

HTTP Request:

GET https://graph.facebook.com/v19.0/{instagram-user-id}?fields=id,username,media_count&access_token={access-token}

Using curl:

curl -i -X GET \
 "https://graph.facebook.com/v19.0/{instagram-user-id}?fields=id,username,media_count&access_token={access-token}"

Expected JSON Response:

{
  "id": "17841400000000001",
  "username": "my_instagram_business_account",
  "media_count": 123,
  "ig_id": "17841400000000001"
}

This response confirms that your setup is correct and your access token is valid. The id is the Instagram user ID, username is the profile handle, and media_count indicates the number of posts on the account.

Common next steps

After successfully making your first API call, consider these common next steps to further develop your integration with the Instagram Graph API:

• Explore More Endpoints: Consult the Instagram Graph API reference to discover other available endpoints for media management, insights, comments, and more.
• Implement Webhooks: Set up webhooks to receive real-time notifications about changes to Instagram accounts, such as new comments or mentions. This eliminates the need for constant polling and improves efficiency. Webhooks are a common pattern for event-driven architectures, as described in Google Cloud's event-driven architecture documentation.
• Handle Permissions and App Review: For your app to access broader user data or to be used by a wider audience, you will need to submit it for App Review. This process ensures your app complies with Meta's platform policies and justifies its requested permissions.
• Error Handling: Implement robust error handling mechanisms to gracefully manage API rate limits, invalid tokens, and other potential issues documented in the Graph API error handling guide.
• SDK Integration: Consider using one of the official Meta Platform SDKs (e.g., for JavaScript, PHP, Python) to simplify development and interaction with the API.

Troubleshooting the first call

Encountering issues during your initial API call is common. Here's a guide to common problems and their solutions:

1. Invalid Access Token

• Symptom: Error messages like "OAuthException: Invalid OAuth access token." or "Error validating access token: Session has expired."
• Solution: Ensure your access token is current and valid. Short-lived tokens expire quickly. If using a short-lived token generated by the Graph API Explorer, try generating a new one. For production, exchange short-lived tokens for long-lived tokens. Verify the token using the Access Token Debugger.

2. Missing Permissions

• Symptom: Error messages indicating insufficient permissions, such as "(#200) Permissions error".
• Solution: Check that the access token you're using has the necessary permissions (e.g., instagram_basic, instagram_manage_comments, instagram_content_publish). During the user authorization flow, ensure the user explicitly granted these permissions. For advanced permissions, your app may require App Review.

3. Incorrect API Version

• Symptom: Unexpected responses or errors related to endpoint availability.
• Solution: Always specify the latest stable API version in your requests (e.g., v19.0 as of this writing). The Graph API Changelog provides updates on versions and deprecations.

4. Incorrect Instagram User ID

• Symptom: The API returns an error stating the object cannot be found or is invalid.
• Solution: Double-check that you are using the correct Instagram Business Account ID, not the Facebook Page ID or a personal Instagram account ID. The correct Instagram Business Account ID can be obtained by querying the /me/accounts endpoint with a Facebook Page access token.

5. Rate Limit Exceeded

• Symptom: Error messages indicating that the rate limit has been reached.
• Solution: The Instagram Graph API imposes rate limits based on active users and type of calls. Implement exponential backoff for retries. Review your application's logic to minimize unnecessary calls.