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

# Instagram

> Manage Instagram business and creator account content, comments, insights, and direct messages via your connected account.

Use Instagram when your workflow needs to publish content, review comments, check insights, or handle direct messages. It works with Instagram Business and Creator accounts.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Instagram account to use for this step. |
| Action | Yes | The Instagram action to perform (for example Get account info, List conversations, Get conversation, List messages). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Instagram in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Get account info** | Get the connected Instagram business or creator account details and statistics. |
| **List conversations** | List Instagram direct message conversations for the connected account. |
| **Get conversation** | Get details for a specific Instagram direct message conversation. |
| **List messages** | List messages from a specific Instagram direct message conversation. |
| **Send text message** | Send a text message to an Instagram user in direct messages. |
| **Mark conversation seen** | Mark Instagram direct messages as seen for a specific user. |
| **List user media** | List published media for an Instagram business or creator account. |
| **Get media** | Get a published Instagram media object by ID. |
| **Create carousel container** | Create a draft carousel container for an Instagram post. |
| **Create media container** | Create a media container for an Instagram post. |
| **Publish media** | Publish a media container to an Instagram business account. |
| **List media comments** | List comments on an Instagram media object. |
| **Create media comment** | Create a comment on an Instagram media object. |
| **Reply to comment** | Create a reply to an Instagram comment. |
| **List comment replies** | List replies to a specific Instagram comment. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Instagram response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Instagram if you have not already done that.
2. Add an **Instagram** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get account info** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Publish a carousel post

1. Create carousel container
2. Publish media
3. Get media

### Reply to a comment

1. List media comments
2. Reply to comment
3. List comment replies

### Handle a DM

1. List conversations
2. Get conversation
3. Send text message
4. Mark conversation seen

## Notes

* This step depends on a connected Instagram integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Instagram tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Instagram as an Agent Tool

You can also add Instagram as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Instagram**. In the tool settings panel, choose the connected account the agent should use. The agent calls Instagram actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


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