The Instagram Story API

Schedule and auto-post Instagram Stories from your own code — including native stickers like links, polls, hashtags and mentions. Plain HTTP and JSON, so any language and any HTTP client works. No SDK required.

The Story API Instagram never shipped

Instagram's official content publishing API can upload plain Story media for business accounts, but it cannot add the interactive elements that make Stories work: no link stickers, no polls, no hashtags, no mentions.

Storrito fills that gap. The API posts real Instagram Stories with native, tappable stickers — the same Stories you could post from the Instagram app, created and scheduled from your code instead.

  • Schedule Stories with images or videos, or post immediately
  • Native Instagram stickers: hashtags, mentions, locations, polls, links, and more
  • List connected Instagram accounts and post to any of them
  • Check the status of queued Stories and cancel them before they go live
  • Works with personal, creator, and business accounts

Two requests to your first scheduled Story

Authenticate with a Bearer token from your Storrito account, list your connected Instagram accounts, and schedule a Story:

curl -X POST https://YOUR-BASE-URL/api/v1/list-instagram-users \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
curl -X POST https://YOUR-BASE-URL/api/v1/schedule-instagram-story \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "instagramUsername": "your_account",
    "scheduledAt": "2026-10-01T09:00:00Z",
    "imageUrl": "https://example.com/story.jpg"
  }'

Every procedure, all request and response schemas, and copy-paste examples are in the API documentation.

Design Stories with HTML

Stories are built with Story Components: plain HTML and CSS plus a small set of web components. Drop an <insta-hashtag>, <insta-mention>, or <insta-link> into your markup and Storrito converts it into a native Instagram sticker.

<insta-story>
  <h1>Fresh drop is live 🔥</h1>
  <insta-link href="https://your-shop.example">Shop now</insta-link>
  <insta-hashtag>#newarrivals</insta-hashtag>
</insta-story>

Anything HTML can express — gradients, custom fonts, images, layouts — becomes a real Instagram Story. See the Story Components reference for the full set.

Built for AI coding agents

The API is predictable and self-documenting, so agents like Claude Code, Cursor, and GitHub Copilot can build a working integration from a short prompt. Point your agent at the documentation URL, describe the Stories you want to schedule, and review the result.

Read https://storrito.com/documentation/api/v1/index.md and write a
script that schedules an Instagram Story for tomorrow 9am with a link
sticker to our latest blog post. Ask me for the Bearer token before
writing any code.

Frequently Asked Questions

Do I need an Instagram business account?

No. The API posts to personal, creator, and business accounts alike — unlike Instagram's official publishing API, which is limited to professional accounts.

How do I authenticate?

With a Bearer token. Create one in your Storrito account under API Credentials; the same screen shows your personal API base URL.

What are the rate limits?

60 API requests per minute and 100 Story posts per Instagram account per 24 hours on Storrito's side. Instagram itself tolerates roughly 15–25 Stories per account per day, so space your posts out.

Which stickers can the API add?

Native Instagram stickers, including hashtags, mentions, locations, links, and polls. Each sticker is a small HTML web component in your Story markup.

Is there an SDK?

You don't need one. The API is plain HTTP with JSON bodies, so curl, fetch, requests, or any HTTP client in your language of choice works directly.

Ship your Instagram Story integration today

Create a free account, generate an API credential, and schedule your first Story in minutes.

The first $2 are on us – no credit card required