How to post to Instagram with Claude: prompts, rules and what fails

By Ranjit Bhinge, founder of Blur Studio · Updated · 9 min read

Short answer: Claude, Anthropic's AI assistant, cannot post to Instagram, Meta's photo and video app, on its own. It needs a connected tool such as Blotato, a software subscription that publishes and schedules social media posts, linked through MCP (Model Context Protocol, the standard that lets Claude use outside tools). Once connected, you ask in plain words and Claude calls Blotato's create-post tool. Instagram needs an image or video on every post, so a caption alone fails.

Ranjit Bhinge

You want to tell Claude what to post to Instagram and have it appear, and you want prompts that name the details Instagram is strict about, so the post does not fail or land in the wrong format.

I'm Ranjit, and I run Blur Studio: 15+ years building software, 120 apps taken live, and clients who have gone on to raise $10M+. I build AI systems and processes that help businesses do a lot more with a lot less time. I also work differently from most of what else is out there, more on that further down this page. Say hello.

This page gives prompt patterns for five Instagram formats and the rules behind each one. It assumes Claude is already connected to Blotato. If it is not, start with the 10 minute setup guide. The API and MCP need a paid plan from Blotato's site, which starts at $29 a month billed monthly as of November 2026, and they are not in the 7 day trial.

None of the prompts below has been run by Blur Studio. They are built from Blotato's published field names. Treat them as a test plan, and the test log near the end gives you a place to record what happens.

This page may contain affiliate links from which Blur Studio earns commissions.

Rules first: what Instagram and Blotato require

RuleWhat the sources say
Account typeA Business or Creator account (together called professional). Blotato says personal accounts fail to connect. Connect with Instagram login, not through Facebook.
Media is requiredEvery post needs at least one image or video. Blotato says a caption alone fails, so it does not do text-only Instagram posts.
CaptionUp to 2,200 characters. Check Meta's current page for the hashtag and tag limits.
Feed imageJPEG or PNG, up to 8 MB, at least 320 pixels wide, shape between 4:5 (tall) and 1.91:1 (wide). Square is safest. These figures are Blotato's. Meta's page names JPEG as the supported image format, so choose JPEG when in doubt.
CarouselBlotato lists 2 to 10 items. Meta's API allows up to 20. The first item sets the crop for all the others.
ReelMP4 or MOV, 3 seconds to 15 minutes, up to 300 MB, 9:16 recommended.
StoryOne image or one video, video up to 60 seconds. No caption, no link sticker, no tagging people through the API.
Daily capBlotato applies 50 posts per account in 24 hours. Meta's own publishing page (updated 20 October 2026) gives 100 in its Rate Limit section and 50 in its carousel section, so treat 50 as the safe limit.
AI labelMeta's API accepts a self-disclosure flag for AI content. Blotato says it does not pass that flag yet and has no draft option for Instagram, so posts sent through Blotato carry no AI label. Meta's help centre says a label may be required for photorealistic video and realistic audio, not images, though Meta can still label an image it detects as AI made (Meta Help Centre, November 2026), so label such media before you post it.

Platform limits change. Check the Instagram limits cheat sheet and Meta's page before you rely on a number.

What Claude actually sends

Claude calls the blotato_create_post tool in the Blotato connector with flat arguments: accountId, platform set to instagram, text for the caption and mediaUrls for the files. For Instagram the extra fields are mediaType (reel or story), collaborators (usernames without the at sign), altText, coverImageUrl, shareToFeed and audioName for Reels, trial for trial Reels, and firstComment. Add scheduledTime to schedule. A REST-style post object pasted into the MCP call fails, because the two shapes differ.

Media goes in as a public web address with no login. For files on your computer, Blotato offers a presigned upload step (a one-time upload address), covered in the setup guide. Always ask Claude to look up the account first, so the ID comes from blotato_list_accounts and not from memory.

Prompt: single image to the feed

Use blotato_list_accounts and find my Instagram account TEST-ACCOUNT-NAME.
Post this image to the feed with this caption. Do not set mediaType.
Image: https://example.com/photo.jpg
Caption: Fresh batch of sourdough out of the oven today. Link in bio.
Before you call blotato_create_post, show me the account ID, the media URL and the caption.
After it submits, call blotato_get_post_status and report the status and public link.

Blotato's publish reference says the Instagram mediaType is optional, with reel as the default for videos, and its own image example leaves mediaType out. So leave it out for a feed image. On your first image post, open Instagram and confirm it appeared as a feed image.

Post these 5 images as one Instagram carousel to TEST-ACCOUNT-NAME, in this order.
Use the same 1:1 shape for all of them.
Images: [list of 5 public JPEG URLs]
Caption: 5 things we check before every delivery. Swipe through.
Do not add collaborators. Show me the list before you post.

Why those lines: the first slide sets the crop for every slide, so one tall or wide slide can fail the whole post. Blotato says JPEG publishes more reliably than PNG for carousels, and each image should be at least 320 pixels wide. Collaborators on a carousel fail with an error such as "The param collaborators is not allowed for carousel child". Video slides lose their audio inside a carousel, which Blotato says is an Instagram-side limit.

Prompt: Reel

Post this video as an Instagram Reel to TEST-ACCOUNT-NAME with mediaType reel.
Video: https://example.com/clip.mp4 (vertical 9:16, under 300 MB)
Caption: How we pack a rush order in 40 seconds.
Cover image: https://example.com/cover.jpg (coverImageUrl)
Also share to the main feed (shareToFeed true).
First comment: Full price list at the link in bio.

Blotato converts videos for you only when they run 120 seconds or less. A longer Reel must already meet Instagram's specs: 9:16, 1080 by 1920 or 720 by 1280, MP4 with H.264 video and AAC audio, bitrate 25 Mbps or lower, 300 MB or lower. Blotato gives an example of a Reel rejected at 1340 by 2160 pixels because it had too many pixels. Trial Reels, which show first to non-followers, use the trial field. Read Blotato's schema before you set it.

Prompt: Story

Post this image as an Instagram Story to TEST-ACCOUNT-NAME with mediaType story.
Image: https://example.com/story-9x16.jpg
Leave the text field empty. The words are already in the image.
Do not attach more than one image.

Stories do not take captions through the API, so words must be inside the image or video. Send exactly one image or one video. If a Story shows up as a feed post, check that you did not attach more than one file. Add link stickers, mentions and music in the Instagram app after it posts. The Stories guide has more.

Prompt: schedule for later

Schedule the carousel above for Friday 18 December 2026 at 9:00 AM in my local time, UTC+0 (London).
Send scheduledTime as an ISO 8601 date with the UTC offset.
Then call blotato_list_schedules and read back the time Blotato stored.

Put your own date, time and offset in. A scheduled post still publishes at its time, so scheduling is not a safe holding place. If you change your mind, ask Claude to use blotato_update_schedule or blotato_delete_schedule. The useNextFreeSlot option only helps if you have set weekly slots in the Blotato calendar, and managing slots is not possible through MCP.

What fails, and the first fix

Error or symptomLikely causeFirst fix
"The media could not be fetched from this URI"Meta rejected a fileRetry once. Check the shape is between 4:5 and 1.91:1, use JPEG, make the first carousel slide the shape you want.
Post fails with only a captionNo mediaAdd an image or video URL.
"An internal server error occurred"Temporary Instagram outageBlotato says it retries twice. Wait a few hours, then retry from the failed list.
"Instagram rejected your post" again and againInstagram spam checks (Blotato's view)Stop retrying. Space posts out and use the app by hand for a week.
Story shows as a feed postPossibly more than one media item, or mediaType missingSend exactly one image or video and set mediaType to story.
Cannot connect the accountPersonal account, or brand-new accountSwitch to professional. See the connection fix list.

Never let Claude retry a failed post blindly. Blotato's guidance is to find the original post first, because it may already exist, and to fix the named error before sending again. The full list is in how to fix a failed Instagram post.

Check that it really went live

A status of published carries a public link. Open it in a private browser window while logged out. Then check three things inside Instagram: the format (feed, Reel or Story), the caption and first comment, and the order of carousel slides. Blotato says analytics are refreshed in the background, so a new post may show no numbers yet. Do not judge a post on the first hour.

Safety

  • Run every prompt on a spare, warmed-up professional account first. Blotato advises warming new accounts by hand for one to two weeks.
  • Set the create-post tool to ask before it runs, if you use Claude Code, so you read the account ID and caption each time.
  • Never paste your Instagram password or a token into Claude. You connect the account through Instagram's own login in Blotato.
  • Do not let Claude post anything it pulled from comments, emails or web pages without you reading it. Outside text can carry hidden instructions.
  • Check Meta's current rules on AI labels. Blotato does not pass the AI flag and has no Instagram draft, so decide before you post whether your AI media needs a label, and consider posting that item by hand.

Copy-ready test log

PromptResult (published, scheduled, failed)Format in InstagramExact error text
Single image
5 slide carousel
Reel with first comment
Story, one image
Scheduled post, time read back

A pass means the format in Instagram matches what you asked for, and the time read back matches your time zone. Any other result is a fail to write down, not to argue with.

Who should skip this

If you post once or twice a week from your phone, posting by hand in the Instagram app is simpler, and Meta's own scheduling tools may be enough, so check what they offer your account. Claude and Blotato make sense when you batch a lot of content, reuse one idea across platforms, or want Claude to draft and queue a week at once. Blotato also does not post text-only content to Instagram, does not add link stickers to Stories and does not pass Meta's AI label flag.

How this page was checked

The facts come from Blotato's pricing page, Blotato's help pages for Instagram posting, limitations and MCP tools, and Meta's Instagram content publishing documentation. Last checked 21 November 2026 and refreshed every 90 days. Blur Studio has not run Blotato itself. The prompts are a plan for you to test with the 7 day trial route for the web app, and on a paid plan for the Claude connection.

How I'd approach this

I would start with the carousel, because it is the format most people want and the one with the most traps. Day 1: connect a spare professional account and post one image by hand in Blotato. Day 2: connect Claude and run the image prompt. Day 3: run the carousel with five square JPEGs. Day 4: run a Reel under 120 seconds. Day 5: schedule one post two days ahead and read the time back. Day 6: break one rule on purpose, such as a PNG first slide, and record the error. Day 7: decide whether to keep the Claude route or stay with the Blotato web app alone. For a wider look at your content routine, the free AI brainstorm call is open, and the free AI tools may help with captions.

Questions people ask

Can Claude post to Instagram without Blotato?

Not by itself. Claude needs a tool that holds your Instagram connection and publishes for it. Blotato is one such tool. See the setup guide.

Can Claude post a text-only Instagram post?

No. Instagram needs at least one image or video, and Blotato says a caption alone fails. See the text-only rules.

What image shape should I use?

Blotato says feed images must sit between 4:5 and 1.91:1, and square is safest. In a carousel, the first slide sets the shape for every slide.

Can Claude add a caption to an Instagram Story?

No. Stories do not take captions through the API. Put the words inside the image or video before posting.

How many Instagram posts can Claude send in a day?

Blotato applies 50 posts per account in 24 hours. Meta's own page gives 100 and 50 in different places, and its quota reference shows 50, so 50 is the safe limit. See the limits cheat sheet.

Will Instagram label my AI content?

Meta's help centre says a label may be required for photorealistic video and realistic audio, not images, though Meta can still label an image it detects as AI made (Meta Help Centre, November 2026). Blotato says it does not pass Meta's AI flag and has no Instagram draft, so posts through Blotato carry no label.

What if a post fails?

Read the exact error, find the original post with its submission ID before retrying, and fix the named problem. See failed post fixes.

More in this topic: Social media: Claude, ChatGPT and AI agent workflows (24 guides) →

Sources

Ready for the next step?

A free 15-minute AI brainstorm. We find 3 broad areas where AI could help your business.

Ranjit Bhinge You talk to me, Ranjit. I reply within a few hours.
Book a free AI brainstorm call

Not sure what you need? Tell me what is going on. I will point you the right way, even if it is not me.

Blur Studio · 30 minute call

Book a 30 minute call

You talk to me, Ranjit. If you do not need me, I will tell you.

  • We talk about your business and what is going on.
  • You leave with a clear next step, even if it is not me.
  • I reply to every message within a few hours.
Loading the calendar…