Instagram for Business
Social MediaPublish and manage Instagram Business content through the Meta Graph API. Agents publish photos, reels, stories, and carousels with automatic status polling, moderate comments with replies and hides, pull account and media insights, and search public hashtags.
What This Integration Enables
Instagram is a stage with no backstage: once a post publishes, it is in front of the audience, and this connector has no action that takes a published post back down. That is why automating a brand account is an orchestration problem, not a scripting problem. FlowRunner agents run the whole Graph API publishing flow, container creation, transcoding polls, and publish calls, for photos, reels, stories, and carousels, then keep working after the post is live: moderating comments, pulling insights, and researching hashtags, all within Instagram's real quotas. - Publish photos, reels, stories, and 2 to 10 item carousels with automatic status polling - Respect the platform's hard limits: 50 API posts per rolling 24 hours, 30 unique hashtag queries per week - Moderate at machine speed with List Comments, Reply to Comment, and Hide or Unhide Comment - Pull account and per-post insights into reports the team can actually query - Route every public-facing publish and every permanent delete through [human-in-the-loop](/concepts/human-in-the-loop) review
Without FlowRunner
With FlowRunner
Use Case Scenarios
The content calendar that ships itself
Approved artwork sits in [Google Drive](/integrations/google-drive-api), and the weekly schedule lives in [Airtable](/integrations/airtable). When a row's publish time arrives, the agent checks Get Publishing Limit, assembles the caption, and posts the exact preview to the social lead. On approval, Publish Photo or Publish Reel runs the container flow, polling transcoding until FINISHED, and Create Comment seeds the first comment with the hashtag block kept out of the caption. The permalink and remaining quota land in [Slack](/integrations/slack). If a container comes back ERROR or EXPIRED, the failure reason goes to the same channel instead of silently dropping a calendar slot.
Comment triage on every fresh post
For each post published in the last day, the agent calls List Comments and classifies what it finds. Routine questions get a Reply to Comment answer drawn from the team's approved responses. Obvious spam gets Hide or Unhide Comment, which keeps the comment invisible but preserved. Anything hostile, legal-adjacent, or from a recognizable customer account is escalated with full thread context, because Delete Comment is permanent and a deleted complaint has a way of resurfacing elsewhere. The team wakes up to a triaged queue instead of a wall of unread notifications.
The growth report nobody has to compile
Every Monday the agent calls Get Account Insights for reach, engaged accounts, and follower count, then walks the week's posts with List Media and Get Media Insights. Results append to [Google Sheets](/integrations/google-sheets) keyed by post id and media type. Once a month, Search Hashtag resolves a shortlist of candidate tags and Get Hashtag Top Media samples what is winning, spending the 30-per-week hashtag budget deliberately instead of burning it on ad hoc curiosity.
Human-in-Loop Highlight
Two operations on this connector deserve a named human. Publish Reel and its siblings put content in front of the brand's entire audience the moment they run, and nothing in the action list can unpublish a post; a bad caption or the wrong asset is a public event, not a rollback. And Delete Comment cannot be undone, which matters most exactly when it is tempting: deleting a customer complaint instead of answering it. So FlowRunner agents prepare, poll, and stage at machine speed, then stop. The social lead sees the final caption and asset before Publish Photo fires, and any comment marked for deletion arrives as an escalation with the full thread attached. Hide or Unhide Comment is the agent's tool; Delete Comment is a person's decision.
Agent Capabilities
23 actionsPublishing
6- Publish Photo Publishes a single photo to the Instagram feed using the Graph API two-step container flow. The image URL must be a publicly reachable JPEG. Supports a caption with hashtags and mentions, an optional location tag, and user tags. Counts against the 50 API posts per 24 hour limit.
- Publish Reel Publishes a Reel from a publicly reachable MP4 or MOV, polling the container every five seconds until transcoding finishes before publishing. Surfaces ERROR and EXPIRED processing failures with the reported reason. Optionally sets a cover image and whether the Reel also appears in the main feed.
- Publish Story Publishes a 24 hour Story from either an image or a video. Image Stories publish immediately; video Stories are polled until processing completes. Provide exactly one of image URL or video URL.
- Publish Carousel Publishes a 2 to 10 item carousel of photos and videos. Creates a child container per item, polls video children until ready, then publishes the parent container. A carousel counts as a single post against the daily limit.
- Get Container Status Retrieves the processing status of a media container between the create and publish steps. Status is IN_PROGRESS, FINISHED, ERROR, EXPIRED, or PUBLISHED, with a human-readable detail message.
- Get Publishing Limit Reports how many API posts the account has published in the rolling 24 hour window against the quota of 50. The check every bulk publishing workflow should run first.
Media
3- List Media Lists the account's published posts, reels, and carousels newest first, with caption, media type, permalink, timestamp, and engagement counts. Supports cursor paging.
- Get Media Retrieves a single media object by id, including caption, media type, URLs, permalink, like and comment counts, and child media for carousels.
- Get Media Children Lists the child items of a carousel album with their media type, URLs, and permalinks. Single photos and videos return an empty list.
Comments
6- List Comments Lists top-level comments on a media object with text, username, timestamp, like count, and nested replies. The sweep step behind every moderation workflow.
- Get Comment Retrieves a single comment by id, including its text, hidden state, and replies.
- Create Comment Posts a top-level comment on media the account manages. Commonly used to seed the first comment with a hashtag set.
- Reply to Comment Posts a threaded reply to an existing comment. The action that answers routine questions at machine speed.
- Hide or Unhide Comment Hides or unhides a comment. Hidden comments remain but are not shown publicly, which makes this the reversible moderation tool agents should reach for first.
- Delete Comment Permanently deletes a comment. This cannot be undone, which is why moderation workflows route it through human review.
Insights
2- Get Account Insights Retrieves account-level metrics such as reach, accounts engaged, total interactions, follower count, and profile views, by day, week, or 28 day period, with optional date bounds. Interaction and time-series metric families must be requested separately.
- Get Media Insights Retrieves per-post metrics from reach, likes, comments, saves, shares, views, and total interactions. Availability varies by media type; reach and total interactions are the most broadly supported.
Account
3- Get Account Info Retrieves profile details for the connected Business or Creator account: username, name, biography, website, follower and media counts, and profile picture URL.
- List Connected IG Accounts Lists the Instagram Business and Creator accounts reachable through your Facebook Pages, pairing each Page with its linked Instagram account id and username. Use those ids to target other actions.
- Get Tagged Media Lists media in which the account has been tagged, with caption, media type, and permalink. The raw material for tracking mentions and user-generated content.
Hashtags
3- Search Hashtag Resolves a hashtag name to its hashtag id, which the top and recent media actions require. Queries count against the 30 unique hashtags per rolling 7 day window.
- Get Hashtag Top Media Lists the most popular public media for a hashtag, with caption, permalink, and like count. Used to study what is winning a tag before committing to it.
- Get Hashtag Recent Media Lists the most recently published public media for a hashtag. Used to watch a tag in near real time during campaigns.
Frequently Asked Questions
What can FlowRunner do with Instagram for Business?
FlowRunner agents can run Publish Photo, Publish Reel, and Publish Story in Instagram for Business, plus 20 more actions.
Does connecting Instagram for Business to FlowRunner require OAuth?
Yes. Instagram for Business connects to FlowRunner with OAuth 2.0, so agents authenticate without handling raw credentials.
Can Instagram for Business trigger a FlowRunner workflow automatically?
Instagram for Business doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with Instagram for Business
$100 in credits. No card required. Connect in minutes.