Instagram Graph API
Official Instagram Graph API profile for Instagram Professional accounts. Create a Meta app, connect an Instagram Business or Creator account, request the documented permissions, and obtain a Meta user/Page access token. Send it as Authorization: Bearer TOKEN. Content publishing uses a two-step container and media_publish flow; personal accounts are not supported by these endpoints. Rate limits, review, media requirements, and permissions are controlled by Meta.
Connect this API to an AI agent Browse all specs
What you can do with Instagram Graph API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /{ig-user-id}/media |
list_instagram_media | List Instagram media Method: GET Path: /{ig-user-id}/media IMPORTANT: This function has 1 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - ig-user-id: Instagram Professional account ID Query Parameters: OPTIONAL: - fields: Comma-separated media fields - limit: Maximum number of media objects |
| POST | /{ig-user-id}/media |
create_instagram_media_container | Create a media container Method: POST Path: /{ig-user-id}/media IMPORTANT: This function has 2 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - ig-user-id: Instagram Professional account ID Request Body: REQUIRED: - media_type: IMAGE, VIDEO, CAROUSEL, or REELS. OPTIONAL: - image_url: image_url parameter from application/json - video_url: video_url parameter from application/json - caption: Text content. |
| POST | /{ig-user-id}/media_publish |
publish_instagram_media | Publish a media container Method: POST Path: /{ig-user-id}/media_publish IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - ig-user-id: Instagram Professional account ID Request Body: REQUIRED: - creation_id: Provider resource identifier. |
| GET | /{media-id} |
get_instagram_media | Read Instagram media Method: GET Path: /{media-id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - media-id: Instagram media ID Query Parameters: OPTIONAL: - fields: Comma-separated media fields |
| GET | /{media-id}/comments |
list_instagram_comments | List media comments Method: GET Path: /{media-id}/comments IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - media-id: Instagram media ID |
| POST | /{media-id}/comments |
create_instagram_comment | Create a media comment Method: POST Path: /{media-id}/comments IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - media-id: Instagram media ID Request Body: REQUIRED: - message: Text content. |
| DELETE | /{comment-id} |
delete_instagram_comment | Delete a comment Method: DELETE Path: /{comment-id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - comment-id: Instagram comment ID |
Usage guide
## Authentication Official Instagram Graph API profile for Instagram Professional accounts. Create a Meta app, connect an Instagram Business or Creator account, request the documented permissions, and obtain a Meta user/Page access token. Send it as Authorization: Bearer TOKEN. Content publishing uses a two-step container and media_publish flow; personal accounts are not supported by these endpoints. Rate limits, review, media requirements, and permissions are controlled by Meta. ## Endpoint coverage This listing contains 5 documented path(s) and 7 operation(s). Review each operation's required OAuth scope or token type before use. ## Official documentation [Instagram developer documentation](https://developers.facebook.com/documentation/instagram-platform/content-publishing)
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Instagram Graph API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.