It’s a Planv1.12.0

Integrations/Instagram

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.

Instagraminstagram.com

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

In a run

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.

Succeeded in 1m 02sSOC-54 Carousel: three ways to use the spring planner
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

  1. 17:58:02get_issue{"key":"SOC-54"}
  2. 17:58:04list_attachments{"issue":"SOC-54"}
  3. 17:58:06instagram_content_publishing_limit{}
  4. 17:58:09instagram_publish_post{"items":[…3]}
  5. 17:59:01add_comment{"issue":"SOC-54"}
  6. 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/…" }

Tools

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_account

List Media

List the connected account's own published media (posts, reels), most recent first, with pagination cursors.

instagram_list_media

List Stories

List the connected account's currently active stories (live for the last 24 hours).

instagram_list_stories

List Tagged Media

List media in which the connected account has been tagged by other users.

instagram_list_tagged_media

List Live Media

List the connected account's currently active live video broadcasts.

instagram_list_live_media

Content 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_limit

Recently Searched Hashtags

List hashtags the account has searched in the last 7 days.

instagram_recently_searched_hashtags

Discovery

Business Discovery

Read another public Instagram Business/Creator account by username: profile stats and recent media.

instagram_business_discovery

Media

Get Media

Read a single Instagram media object (post, reel, story) by its media id.

instagram_get_media

Media Children

List the child media (photos/videos) of a carousel album post.

instagram_media_children

Update Media

Enable or disable comments on one of the connected account's own media.

instagram_update_media

Delete Media

Permanently delete one of the connected account's own media (posts/reels).

instagram_delete_media

Comments

List Comments

List top-level comments on a media object, with pagination cursors.

instagram_list_comments

Create Comment

Post a top-level comment on a media object (the connected account's own or another public post).

instagram_create_comment

Get Comment

Read a single comment by its id.

instagram_get_comment

List Comment Replies

List the replies to a comment.

instagram_list_comment_replies

Reply To Comment

Post a reply to an existing comment.

instagram_reply_to_comment

Hide Comment

Hide or unhide a comment on one of the connected account's own media.

instagram_hide_comment

Delete Comment

Delete a comment on one of the connected account's own media.

instagram_delete_comment

Mentions

Reply To Mention

Reply to a place where the connected account was @mentioned.

instagram_reply_to_mention

Get Mentioned Comment

Read a specific comment (by id) in which the connected account was @mentioned.

instagram_get_mentioned_comment

Get Mentioned Media

Read a specific media object (by id) whose caption @mentioned the connected account.

instagram_get_mentioned_media

Hashtags

Hashtag Search

Resolve a hashtag name to its id, needed by the top/recent media tools.

instagram_hashtag_search

Hashtag Top Media

Read the most popular public media tagged with a hashtag.

instagram_hashtag_top_media

Hashtag Recent Media

Read the most recent public media tagged with a hashtag (only media from the last 24 hours).

instagram_hashtag_recent_media

Insights

Account Insights

Read account-level insights for the connected account.

instagram_account_insights

Media Insights

Read insights for a single media object.

instagram_media_insights

Publishing

Create Media Container

Create a media container (step 1 of publishing).

instagram_create_media_container

Create 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_carousel

Container Status

Read a media container's processing status.

instagram_container_status

Publish Media

Publish a finished media container (step 2 of publishing).

instagram_publish_media

Publish Post

Publish a photo post in one call: creates the container(s), waits for processing, and publishes.

instagram_publish_post

Set up

Connect Instagram once for the team

  1. Get a long-lived token

    Meta for Developers › your app

    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.

  2. Add the token and the account id

    Team settings › Integrations › Add credential

    Paste the token and the Instagram user id of the account. It’s a Plan checks them before you save.

  3. Pick the tools

    Team settings › Tools › Add tool

    Add the Instagram tools for the team, then turn on the ones each agent may use.

Beacon›Add tool

Search tools

Instagram32 toolsSelect all
Create Media ContainerCreate a media container (step 1 of publishing).
Create Carousel ContainerCreate a CAROUSEL parent container (2-10 items) from child container ids made with instagram_create_media_container (each with isCarouselItem set).
Container StatusRead a media container's processing status.
Publish MediaPublish a finished media container (step 2 of publishing).
Publish PostPublish a photo post in one call: creates the container(s), waits for processing, and publishes.
Credential

Brand account

Add credential

Required token permissionsinstagram_basicinstagram_content_publish

3 tools selectedCancelAdd 3 tools

Use cases

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.

Free and Pro

Instagram comes with the free edition

FREE

Instagram and 11 more integrations, on every agent trigger: delegate, mention, chat and schedules.

PRO

HTTP tools for services not on the list, agent workflows, and an agent that starts on every new issue.

See Pro
FAQ

Instagram 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.

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

AGPL-3.0 · No per-seat fees · Use your own AI key or subscription