NewGenerate AI UGC videos with your AI agent using agent-media

Post to Instagram from Grok Bot

Grok Bot can post to Instagram through the Postiz plugin. Add the plugin to a Bot, store your Postiz API key as a secret, and ask for a feed post, story, or reel. The Bot uploads the media, sets the post type, adds collaborators, and schedules it, then keeps posting on a routine from its cloud computer.

Setup Guide Marketplace

Please make sure there is always a human in the loop.

Last updated: September 2026

How to post to Instagram from Grok Bot

Add the Postiz plugin once, then tell your Bot which image or video to post. It uploads the media, sets post_type to post or story, and schedules it in Postiz.

Setup, then just ask

# One-time setup, in any Bot chat
/add-plugin postiz
# Store POSTIZ_API_KEY as a Bot secret when prompted

# Then just ask Grok Bot:
> Post the product photo to Instagram
  with a caption, tomorrow at 6pm

Grok Bot: Done! Your Instagram post is scheduled.

What can Grok Bot do on Instagram?

📷

Feed Posts

Publish photo and video posts to your Instagram feed with captions, hashtags, and location tags. Schedule for optimal engagement times.

📱

Stories

Share ephemeral content with Instagram Stories. Upload images or videos that disappear after 24 hours.

🎬

Trial Reels

Test content with trial reels that have limited initial reach. Graduate to full distribution manually or automatically based on performance.

🤝

Collaborator Tags

Tag collaborators on your posts to co-author content. The post appears on both profiles, doubling your reach.

📊

Graduation Strategy

Control how trial reels graduate to full reach. Choose MANUAL for hands-on control or SS_PERFORMANCE for automatic promotion.

📅

Scheduled Posting

Schedule posts and stories with precise timestamps. Plan your Instagram content calendar and let Postiz handle the publishing.

How does Grok Bot post to Instagram?

You describe what you want in plain language and Grok Bot handles the Postiz calls for you. Here is how a typical conversation goes.

Find Your Instagram Integration

Ask Grok Bot whether your Instagram account is connected. It also checks which options the platform supports.

Example conversation

> Is my Instagram account connected to Postiz?

Grok Bot: Yes — your Instagram account is connected
  and ready. Want me to post something?

Upload Your Media

Upload your photo or video to get a public URL. Instagram requires media to be accessible via HTTPS. Supports JPG, PNG, MP4, and more.

Example conversation

> Draft a Instagram post about our new
  feature launch

Grok Bot: Here's a draft for Instagram:
  "We just shipped something big..."
  Want me to add media and schedule it?

Create Your Post

Schedule an Instagram post with your media, caption, hashtags, and platform-specific settings like post type, trial reels, and collaborators.

Example conversation

> Yes — add screenshot.png and schedule
  it for tomorrow at 9am

Grok Bot: Done! Scheduled on Instagram for
  tomorrow at 9:00 AM.

Instagram Settings Reference

Mention any of these in plain language and Grok Bot sets them for you. These are the Instagram options it can apply to any post.

Field	Type	Required	Description
`__type`	string	Yes	Must be "instagram" or "instagram-standalone"
`post_type`	string	Yes	Content type: "post" (feed) or "story"
`is_trial_reel`	boolean	No	Post as a trial reel with limited initial reach
`graduation_strategy`	string	No	Trial reel graduation: "MANUAL" or "SS_PERFORMANCE" (auto based on performance)
`collaborators`	array	No	List of collaborator objects, e.g. [{"label":"username"}]

Common Instagram configurations

Ask Grok Bot for any of these common Instagram posting scenarios and it applies the matching settings.

Simple Feed Post

Just ask

> Post it with: Simple Feed Post

Grok Bot: Got it. Applying:
  post_type: post

Story Post

Just ask

> Post it with: Story Post

Grok Bot: Got it. Applying:
  post_type: story

Trial Reel with Auto Graduation

Just ask

> Post it with: Trial Reel with Auto Graduation

Grok Bot: Got it. Applying:
  post_type: post
  is_trial_reel: yes
  graduation_strategy: SS_PERFORMANCE

Collaborator Post

Just ask

> Post it with: Collaborator Post

Grok Bot: Got it. Applying:
  post_type: post
  collaborators: cofounder, designer_jane

What is Grok Bot?

Grok Bot is the always-on AI teammate product from xAI and Cursor. You create named Bots, give each one a job, and they work 24/7 on their own persistent cloud computer — with a browser, a filesystem, and a terminal — pinging you only when they need approval.

Grok Bot is not the Grok chatbot. Grok is the assistant you chat with on X and grok.com. Grok Bot is a separate app for delegating real, multi-step work — like running your Instagram presence with Postiz.

💻

Own Cloud Computer

Every Bot gets a persistent cloud machine with a terminal. Postiz runs there, so your Instagram posts go out even when your laptop is closed.

🔁

Routines

Turn any task into a routine that runs on a schedule. Your Bot drafts, schedules, and reports on Instagram content without being asked twice.

🛡️

Approvals Built In

Bots ask before changing external systems. Review the Instagram posts your Bot prepared in Postiz, approve, and it publishes.

How Postiz Works with Grok Bot

Postiz is listed on the Grok Bot plugin marketplace. Add it to a Bot and the Postiz skill, CLI, and command reference are installed on its cloud computer — the Bot can then manage your Instagram workflow on its own.

✓Type /add-plugin postiz in a Bot chat, or add it from the Plugins sidebar
✓Store your POSTIZ_API_KEY as a Bot secret when prompted
✓The Bot reads the bundled SKILL.md and learns every Postiz command
✓Works in every Bot on your shared workspace, on desktop and iPhone
✓Approvals keep a human in the loop before anything is published

Grok Bot

# 1. Add the plugin to your Bot
/add-plugin postiz

# 2. Store your Postiz API key
#    as a secret when prompted

# 3. Ask your Bot to verify
You: Find my Instagram channel in Postiz

Bot: Running postiz integrations:list
  Found your Instagram integration.
  All Postiz commands are ready.

How Grok Bot runs Instagram on a routine

Your Bot reads the Postiz skill, discovers your Instagram integration, and handles the entire posting workflow — from content creation to scheduling — on its own cloud computer.

🧠

Message Your Bot

Desktop, iPhone, or a group chat

Send a message to your Bot from the desktop app or your iPhone. It runs on its own cloud computer, so it picks up your message, discovers your Instagram account via Postiz, uploads your media, and schedules the post — then asks you to approve before it goes live.

Grok Bot

You: Post to Instagram about our new
  feature launch, schedule for tomorrow
  at 9am

Bot: Got it! Here's the plan:
  1. Find your Instagram integration
  2. Compose your post content
  3. Schedule for tomorrow 9:00 AM

  Done! Post scheduled successfully.
  Post ID: abc-123

🧠

Routines

Recurring work on a schedule

Save the task as a routine. Your Bot runs it on a schedule from the cloud, checks for new content, and posts it to Instagram automatically — no manual trigger needed.

Grok Bot routine

Routine: daily-instagram-posts
Schedule: Weekdays at 9:00 AM

Instructions:
  Check ~/content/posts on your cloud
  computer for new .txt files. For
  each one, read the content and
  schedule a post to Instagram for
  today at noon via Postiz. Move
  posted files to ~/content/published
  and send me a summary.

Why Grok Bot + Postiz for Instagram

Grok Bot makes Postiz a natural fit for your Instagram workflow. The Bot reads the plugin's skill, chains the right commands together, and keeps running from the cloud.

✓Official plugin — one command install from the marketplace
✓Always on — posts to Instagram from the cloud while you are away
✓Terminal access runs Postiz commands directly on the Bot's computer
✓Routines for hands-free daily posting
✓Cross-post to Instagram + other platforms in a single conversation
✓Approvals keep a human in the loop before publishing

SKILL.md (bundled in the plugin)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Instagram
metadata:
  grok-bot:
    plugin: postiz
    secrets:
      - POSTIZ_API_KEY
    binaries:
      - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Instagram Settings
post_type, is_trial_reel,
graduation_strategy,
collaborators

Also Works with Claude Code

Postiz works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Anthropic's Claude Code. See the Claude Code guide for Instagram, the guide for any AI agent, or connect over the Postiz MCP server.

Claude Code

by Anthropic

Claude reads the Postiz skill so it knows what it can do, then autonomously discovers your Instagram integration, uploads your photo, applies post type and collaborator settings, and schedules the post.

Claude Code

> Post my product photo to Instagram
  as a feed post with collaborator tags,
  schedule for tomorrow evening

Claude: Done! Scheduled on Instagram for
  tomorrow at 9:00 AM.

Cross-post Instagram content to other platforms

Schedule the same content to Instagram and other platforms in a single request. Each platform gets its own settings.

Example

> Post "Excited to announce our new feature!" to
  Instagram and LinkedIn tomorrow at 9am, then schedule
  a daily tip on Instagram every weekday at 10am

Grok Bot: Done! Scheduled:
  - Instagram + LinkedIn: tomorrow 9:00 AM
  - Daily tips on Instagram: Mon-Fri 10:00 AM

Post Types

Feed Post

post

Story

story

Example prompts for Instagram in Grok Bot

These are prompts you can paste into a Bot chat. Grok Bot maps each one to the matching Postiz commands and Instagram settings, then asks for approval.

Feed post with caption

Grok Bot chat

> Post ~/photos/team-offsite.jpg to Instagram
  with a caption about our offsite, add 5
  relevant hashtags, schedule for 6pm

Grok Bot: Uploaded team-offsite.jpg via
  Postiz. post_type: post. Scheduled 6:00 PM.
  Approve the caption?

Trial reel

Grok Bot chat

> Post ~/videos/demo.mp4 as a trial reel and
  let it graduate automatically if it performs

Grok Bot: is_trial_reel: true,
  graduation_strategy: SS_PERFORMANCE.
  Uploading demo.mp4 now.

Collaborator post

Grok Bot chat

> Share ~/photos/launch.png to Instagram with
  @partnerbrand as a collaborator, tomorrow 9am

Grok Bot: collaborators: [{label: "partnerbrand"}].
  Scheduled tomorrow 9:00 AM.

Instagram rules Grok Bot follows

Grok Bot reads the Instagram rules from postiz integrations:settings before scheduling. These are the ones that most often change what gets published.

✓Instagram posts need media. Grok Bot cannot publish a text-only post, so give it an image or video to upload first.
✓post_type is required and must be post (feed) or story. Stories skip captions in the feed, so say which one you want.
✓Trial reels use is_trial_reel and graduation_strategy (MANUAL or SS_PERFORMANCE). Without a strategy the reel stays in trial mode until you promote it.
✓Instagram accounts connected through Facebook use __type instagram; direct logins use instagram-standalone. Postiz reports the type in integrations:list.

Grok Bot and Instagram: frequently asked questions

How do I post to Instagram from Grok Bot?

Add the Postiz plugin with /add-plugin postiz and store your POSTIZ_API_KEY as a Bot secret. Then ask the Bot to post an image or video. It uploads the file through Postiz, sets post_type to post or story, writes the caption, and schedules it. You approve before it publishes.

Can Grok Bot post Instagram stories and reels?

Yes. Ask for a story and the Bot sets post_type to story. Ask for a reel and it uploads your video as a feed post, optionally as a trial reel with is_trial_reel and a graduation strategy. Each type still needs a media file uploaded through Postiz first.

What is a trial reel and can Grok Bot manage it?

A trial reel is shown to non-followers first with limited reach. Grok Bot sets is_trial_reel to true and graduation_strategy to MANUAL or SS_PERFORMANCE. With SS_PERFORMANCE the reel graduates to your full audience automatically when it performs well.

Can Grok Bot tag collaborators on Instagram posts?

Yes. Name the collaborator account and the Bot adds it to the collaborators list, for example [{label: "partnerbrand"}]. The collaborator receives an invite from Instagram and the post appears on both profiles once accepted. This works on feed posts, not stories.

Can Grok Bot run a daily Instagram posting routine?

Yes. Save a routine such as "every day at 6pm, post the next image from ~/content/instagram". The Bot runs it from its own cloud computer, uploads the media through Postiz, schedules the post, and reports back. Approvals keep a human in the loop before publishing.

Related Grok Bot guides

Start at the Grok Bot social media plugin overview for setup, routines, and the full platform list, or read what Postiz supports on the Instagram channel page.

Grok Bot for TikTok→Grok Bot for Facebook→Grok Bot for Pinterest→Grok Bot for YouTube→Grok Bot for X (Twitter)→

Not using Grok Bot? Postiz works with any AI agent, including over the Postiz MCP server. See pricing for the free trial and plan limits.

Start posting to Instagram

Install Postiz Agent and automate your Instagram content strategy with AI-powered scheduling and publishing.

Get Started