Instagram Business
Publish, inspect, moderate, delete, and monitor Instagram professional account content with the Meta Graph API.
Tools
| Name | Description |
|---|---|
list_business_accountsList Instagram professional accounts connected to Facebook Pages the user can access. | List Instagram professional accounts connected to Facebook Pages the user can access. |
get_profileGet an Instagram professional account profile. | Get an Instagram professional account profile. |
list_mediaList media for an Instagram professional account. | List media for an Instagram professional account. |
get_mediaGet details for an Instagram media object. | Get details for an Instagram media object. |
create_media_containerCreate an Instagram media container for a photo, reel, story, carousel item, or carousel parent. | Create an Instagram media container for a photo, reel, story, carousel item, or carousel parent. |
get_container_statusCheck the processing status for an Instagram media container. | Check the processing status for an Instagram media container. |
publish_mediaPublish an Instagram media container that is ready. | Publish an Instagram media container that is ready. |
upload_photoCreate and publish a photo to an Instagram professional account. Keeps the legacy action name. | Create and publish a photo to an Instagram professional account. Keeps the legacy action name. |
upload_reelCreate a reel container and publish it when processing is already finished, or after a short optional wait. Keeps the legacy action name without a long Worker-blocking poll loop. | Create a reel container and publish it when processing is already finished, or after a short optional wait. Keeps the legacy action name without a long Worker-blocking poll loop. |
publish_photoCreate and publish an Instagram photo. | Create and publish an Instagram photo. |
publish_reelCreate a reel container and publish it when ready. | Create a reel container and publish it when ready. |
publish_carouselCreate and publish an Instagram carousel parent from existing child media container IDs. | Create and publish an Instagram carousel parent from existing child media container IDs. |
delete_mediaDelete an Instagram media object when Meta permits removal by the account owner. | Delete an Instagram media object when Meta permits removal by the account owner. |
set_comments_enabledEnable or disable comments on an Instagram media object owned by the connected account. | Enable or disable comments on an Instagram media object owned by the connected account. |
list_media_commentsList comments on an Instagram media object. | List comments on an Instagram media object. |
create_media_commentCreate a comment on media owned by the connected Instagram professional account. | Create a comment on media owned by the connected Instagram professional account. |
reply_to_commentReply to an Instagram comment. | Reply to an Instagram comment. |
list_comment_repliesList replies on an Instagram comment. | List replies on an Instagram comment. |
hide_unhide_commentHide or unhide an Instagram comment. | Hide or unhide an Instagram comment. |
delete_commentDelete an Instagram comment when Meta permits removal by the media owner. | Delete an Instagram comment when Meta permits removal by the media owner. |
get_account_insightsGet Instagram account insights metrics. | Get Instagram account insights metrics. |
get_media_insightsGet Instagram media insights metrics. | Get Instagram media insights metrics. |
get_content_publishing_limitGet Instagram content publishing quota usage and configuration. | Get Instagram content publishing quota usage and configuration. |
custom_api_callMake a custom Instagram Graph API call. Mutating methods require an exact confirmation string. | Make a custom Instagram Graph API call. Mutating methods require an exact confirmation string. |
Triggers
| Name | Description |
|---|---|
new_mediaTriggers when the Instagram professional account publishes new media. | Triggers when the Instagram professional account publishes new media. |
new_or_updated_mediaTriggers when recently listed Instagram media appears newer than the last poll timestamp. | Triggers when recently listed Instagram media appears newer than the last poll timestamp. |
new_comment_on_mediaTriggers when a selected Instagram media object receives a new comment. | Triggers when a selected Instagram media object receives a new comment. |
publishing_limit_near_quotaTriggers when Instagram content publishing quota usage is at or above the configured threshold. | Triggers when Instagram content publishing quota usage is at or above the configured threshold. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('instagram-business', 'list_business_accounts', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'instagram-business',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect Instagram Business to my app?
Use Weavz Hosted Connect for OAuth2 authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does Instagram Business support?
Instagram Business supports 24 tools including List Business Accounts, Get Profile, List Media, Get Media, Create Media Container, and more.
Can I use Instagram Business with AI agents?
Yes. Add Instagram Business to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect Instagram Business to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add Instagram Business as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped Instagram Business tools exposed by that workspace.
Does Instagram Business work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved Instagram Business work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with Instagram Business?
Instagram Business exposes 24 tools, including List Business Accounts, Get Profile, List Media, Get Media, Create Media Container, and more. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can Instagram Business be used in stateful agent workflows?
Yes. Agents can combine Instagram Business tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does Instagram Business use?
Instagram Business uses OAuth2. Weavz stores OAuth credentials securely and refreshes tokens when supported by the provider.
How much does the Instagram Business integration cost?
The Instagram Business integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does Instagram Business support?
Instagram Business supports 4 triggers including New Media, New Or Updated Media, New Comment On Media, Publishing Limit Near Quota.
Connect Instagram Business in minutes
Get 20,000 free action executions every month. No credit card required.