Instagram automation run by an AI agent
Put the post in an issue: the caption and the images or the video. The agent publishes it, answers the comments and reads the insights back onto the issue.
The Instagram Platform gives apps APIs for Business and Creator accounts: posts, comments and insights.
- Tools
- 32: Publish posts, carousels and reels; comments, mentions, hashtags, insights
- Key
- Access token and Instagram user id
- Edition
- Free in Community
- Starts on
- Delegate, mention, chat or a schedule
See each call the agent makes to Instagram
Every Instagram tool call is a step of the run, with what the agent sent and what came back.
- Agent
- @social · Internal
- Trigger
- Delegate
- Started
- Nov 21, 17:58
- Run
- #418
Result
The carousel is live on Instagram. The link is in a comment on SOC-54.
What the agent did
- 17:58:02get_issue{"key":"SOC-54"}
- 17:58:04list_attachments{"issue":"SOC-54"}
- 17:58:06instagram_content_publishing_limit{}
- 17:58:09instagram_publish_post{"items":[…3]}
- 17:59:01add_comment{"issue":"SOC-54"}
- 17:59:04The carousel is live. The link is in a comment on SOC-54.
instagram_publish_post17:58:09
Input{
"caption": "Three ways to use the spring planner…",
"items": [
{ "imageUrl": "https://plan.example.com/files/1.jpg" },
{ "imageUrl": "https://plan.example.com/files/2.jpg" },
{ "imageUrl": "https://plan.example.com/files/3.jpg" }
]
}Output{ "id": "1790…", "permalink": "https://www.instagram.com/p/…" }32 Instagram tools, each with its own switch
Let one agent read insights and another publish. Each tool needs the matching permission on your token.
Account
Get Account
Read the connected Instagram Business/Creator account's own profile (username, name, bio, website, follower/follows/media counts, profile picture).
instagram_get_accountList Media
List the connected account's own published media (posts, reels), most recent first, with pagination cursors.
instagram_list_mediaList Stories
List the connected account's currently active stories (live for the last 24 hours).
instagram_list_storiesList Tagged Media
List media in which the connected account has been tagged by other users.
instagram_list_tagged_mediaList Live Media
List the connected account's currently active live video broadcasts.
instagram_list_live_mediaContent Publishing Limit
Read how many containers the account has published in the rolling 24-hour window (quota_usage) and the allowed quota (config.quota_total / config.quota_duration).
instagram_content_publishing_limitRecently Searched Hashtags
List hashtags the account has searched in the last 7 days.
instagram_recently_searched_hashtagsDiscovery
Business Discovery
Read another public Instagram Business/Creator account by username: profile stats and recent media.
instagram_business_discoveryMedia
Get Media
Read a single Instagram media object (post, reel, story) by its media id.
instagram_get_mediaMedia Children
List the child media (photos/videos) of a carousel album post.
instagram_media_childrenUpdate Media
Enable or disable comments on one of the connected account's own media.
instagram_update_mediaDelete Media
Permanently delete one of the connected account's own media (posts/reels).
instagram_delete_mediaComments
List Comments
List top-level comments on a media object, with pagination cursors.
instagram_list_commentsCreate Comment
Post a top-level comment on a media object (the connected account's own or another public post).
instagram_create_commentGet Comment
Read a single comment by its id.
instagram_get_commentList Comment Replies
List the replies to a comment.
instagram_list_comment_repliesReply To Comment
Post a reply to an existing comment.
instagram_reply_to_commentHide Comment
Hide or unhide a comment on one of the connected account's own media.
instagram_hide_commentDelete Comment
Delete a comment on one of the connected account's own media.
instagram_delete_commentMentions
Reply To Mention
Reply to a place where the connected account was @mentioned.
instagram_reply_to_mentionGet Mentioned Comment
Read a specific comment (by id) in which the connected account was @mentioned.
instagram_get_mentioned_commentGet Mentioned Media
Read a specific media object (by id) whose caption @mentioned the connected account.
instagram_get_mentioned_mediaHashtags
Hashtag Search
Resolve a hashtag name to its id, needed by the top/recent media tools.
instagram_hashtag_searchHashtag Top Media
Read the most popular public media tagged with a hashtag.
instagram_hashtag_top_mediaHashtag Recent Media
Read the most recent public media tagged with a hashtag (only media from the last 24 hours).
instagram_hashtag_recent_mediaInsights
Account Insights
Read account-level insights for the connected account.
instagram_account_insightsMedia Insights
Read insights for a single media object.
instagram_media_insightsPublishing
Create Media Container
Create a media container (step 1 of publishing).
instagram_create_media_containerCreate Carousel Container
Create a CAROUSEL parent container (2-10 items) from child container ids made with instagram_create_media_container (each with isCarouselItem set).
instagram_create_carouselContainer Status
Read a media container's processing status.
instagram_container_statusPublish Media
Publish a finished media container (step 2 of publishing).
instagram_publish_mediaPublish Post
Publish a photo post in one call: creates the container(s), waits for processing, and publishes.
instagram_publish_postConnect Instagram once for the team
Get a long-lived token
Use a Business or Creator account. Give the token the permissions of the tools you turn on, such as instagram_content_publish and instagram_manage_comments.
Add the token and the account id
Paste the token and the Instagram user id of the account. It’s a Plan checks them before you save.
Pick the tools
Add the Instagram tools for the team, then turn on the ones each agent may use.
Search tools
Brand account
Add credentialRequired token permissionsinstagram_basicinstagram_content_publish
Instagram work you can hand an agent
Column
When a post moves to Ready to publish, @social publishes it and links it on the issue.
Schedule
Every evening at 18:00, @social answers the new comments on the last three posts.
Delegate
Delegate SOC-60 to @social: it reads the insights of last month’s reels and writes what worked.
Instagram comes with the free edition
Instagram and 11 more integrations, on every agent trigger: delegate, mention, chat and schedules.
HTTP tools for services not on the list, agent workflows, and an agent that starts on every new issue.
See ProInstagram AI agent FAQ
Which Instagram accounts work?
Business and Creator accounts, through the Instagram Graph API. Personal accounts have no API access.
Can it answer direct messages?
No. The tools answer comments and mentions. Direct messages are not included.
Can it publish reels and stories?
Yes. The agent makes a media container from a public video link as a reel or a story, then publishes it.
Can it post on a schedule?
Yes. A schedule starts the agent at the time you set, and it publishes the posts that are ready in your column.
Does the agent see my Instagram token?
No. It is stored encrypted on your server. The agent calls a tool by name and gets back only what the tool returns.
What does it cost?
The Instagram tools are free in the Community edition. You pay your AI provider for the model.
More integrations
- Jina AIRead a page as markdown, search the web and fact-check a statement.
- FirecrawlScrape, crawl and map websites, and pull structured data from pages.
- TelegramSend a message to a Telegram chat from your bot.
- ThreadsPublish posts, answer replies and read insights.
- NotionSearch, read and write Notion pages and answer their comments.
- Gitea / ForgejoList, create, update and comment on issues on your own Git server.
- GitHubList, create and update issues and discussions in your repositories.
- PDFRead a PDF from a link as markdown, with pdf-inspector. Needs no key.
- KeenableSearch the web and read pages. Works without a key.
- DataForSEOGet Google results, keyword data, backlinks and page audits.
- KieGenerate images, video, music and speech with Veo, Kling, Nano Banana and Suno.
Hand your next post to an agent
Try the free edition on your computer with one setup command.
Or deploy to Railway in one click