> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruby.ad/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram

> Publish Instagram content, manage comments, answer DMs, and read insights.

![Instagram](https://mintcdn.com/ruby-ai/g1q-iqu1Jq2F3AFP/branding/integrations/instagram.svg?fit=max\&auto=format\&n=g1q-iqu1Jq2F3AFP\&q=85\&s=d4193c7a9becdd9c7142b2a9decfd31b)

> [!NOTE]
>
> Meta integrations are in preview. Ruby enables them per workspace while Meta reviews Ruby's app. If a tool or trigger source is missing, use your Ruby support channel to request access.

Let agents publish on Instagram, handle comments and DMs, and follow your brand's mentions.

## Requirements

An Instagram professional account (business or creator) linked to a Facebook Page. Select both the
Instagram account and its Page when connecting.

## Tools

| Tool | Description | Asks before running |
| - | - | - |
| List Instagram accounts | Connected accounts and their linked Page | Runs automatically |
| List media | Latest posts, reels and carousels | Runs automatically |
| Publish photo | Publish a photo from a public JPEG URL | Asks every time |
| Publish carousel | Publish 2 to 10 photos and videos as one post | Asks every time |
| Publish reel | Publish a reel from a public MP4 URL | Asks every time |
| Publish story | Publish a 24-hour story from an image or video URL | Asks every time |
| Publish media container | Finish publishing a reel or story that took long to process | Asks every time |
| List comments | Comments on a post or reel | Runs automatically |
| Reply to comment | Reply publicly as the account | Asks per account |
| Hide comment | Hide or unhide a comment | Asks once |
| Delete comment | Delete a comment | Asks every time |
| Send private reply | DM the author of a comment | Asks per account |
| List tagged posts | Posts and reels where other accounts tagged you | Runs automatically |
| Look up a business account | Public profile, followers and recent posts of another business or creator account | Runs automatically |
| List DM conversations | Direct message conversations | Runs automatically |
| Read DMs | Latest messages of a conversation | Runs automatically |
| Send DM | Reply within 24 hours of the person's last message | Asks per recipient |
| Get account insights | Reach, views, profile views, followers | Runs automatically |
| Get media insights | Reach, views, likes, saves, shares of a post | Runs automatically |

Good to know:

* Instagram publishes up to 50 posts per account per day; a carousel counts as one.
* Stories have no caption.
* A private reply can be sent once per comment, within 7 days of the comment.
* Look-ups only work for other business and creator accounts, not personal accounts.

## Asks before running

Every tool listed above is available. This column describes whether the agent asks you before using it.

| Value | Meaning |
| - | - |
| Runs automatically | Reads data. The agent uses it without asking. |
| Asks once | The agent asks the first time. You can approve it for good. |
| Asks per recipient / Page / account | The agent asks for each new recipient, Page or account. You can approve it for good for that one. |
| Asks every time | Publishes, deletes, spends money or messages people outside a conversation. The agent asks each time. |

See [Meta overview](https://docs.ruby.ad/docs/user-documentation/agents/tools/meta) for setup, asset access, and approvals. To automate messages or comments, see [Meta triggers](https://docs.ruby.ad/docs/user-documentation/agents/triggers/meta-triggers.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.