Storrito API: Frequently Asked Questions

These are the questions developers ask us most often when building on the Storrito API. For an overview of what the API does and how to authenticate, start with Storrito API: Schedule Instagram Stories Programmatically.

Can I get the published Instagram Story URL or media ID after a Story posts?

Not at the moment. Once a Story posts, status-instagram-story returns the storyPostUuid and the status, but not the published Instagram Story URL or Instagram media ID. Storrito doesn't store the Instagram Story post ID yet, and there's no webhook field or separate endpoint that returns it. It's on our roadmap, but we can't promise a timeline.

Can the API create drafts for my team to review before posting?

There's no draft state in the API. schedule-instagram-story either posts immediately or schedules a Story for a specific date and time. There are two workarounds:

• Schedule far in the future. Set the Story to post on a date far ahead (for example, 6 months out), have your team review it in the Storrito editor, then reschedule it to the time you actually want it to go live.
• Build your own review step. The same <insta-story> Story Components you send to the API also work as a JavaScript tag on any HTML page, so you can render a preview inside your own tooling.

Can I edit, reschedule, or cancel a scheduled Story before it posts?

Yes. A scheduled Story can be opened in the Storrito editor any time before it posts, so you can adjust stickers, swap the image, and change text, then reschedule it to a different time or cancel it. That's what makes the far-future scheduling above a workable stand-in for drafts.

Can the API crosspost to a connected Facebook Page?

No, not yet. The in-app Post and Schedule flow includes crossposting to Facebook, but schedule-instagram-story has no Facebook or crosspost parameter, so Stories posted through the API go to Instagram only.

How do I design Stories and control sticker placement?

You design Stories with Story Components: plain HTML and CSS that Storrito converts into a native Instagram Story with native stickers. Because it's standard HTML and CSS, you lay everything out yourself, and the text adapts to the space available. See the Story Components reference in your API documentation (under API Credentials → Documentation) for examples.

A fast way to get started is to point an AI coding agent like Claude Code at that reference and ask it to build an example HTML file for you.

My API Stories show “retrying” and never post. What's wrong?

A Story that posts fine manually but gets stuck on “retrying” through the API usually points to a problem with the HTML you're sending. Compare your markup against the examples in the Story Components reference in your API documentation (under API Credentials → Documentation) and match that format.

Can I generate a preview image of a Story, for example to share with clients?

Storrito doesn't produce a standalone preview image through the API yet. As a workaround, since you design Stories as HTML and CSS with Story Components, you can render that HTML page and capture a screenshot with a headless browser service such as Browserbase. An AI coding agent like Claude Code can wire this up for you.

If you have a question that isn't covered here, reach out to support and we'll help with your integration.