List an Instagram account's active stories: everything it posted in the last
24 hours, newest first. Use it to let someone pick a story, for example to run
an automation only on replies to that story: the story's id is the story.id
on its replies, and passing it as storyId to
List messages returns everyone who replied.
The list comes live from Instagram on every call, so a story posted a moment ago shows up straight away, and one that has expired is gone.
Query parameters
accountIduuidRequired- The connected Instagram account.
profileIduuid- Optional, because accountId names its profile. If you pass both, they must agree.
Each story has:
Story fields
idstring- The story's Instagram media id.
mediaTypestring | null- IMAGE or VIDEO.
mediaProductTypestring- Always STORY.
mediaUrlstring | null- The image or video. Null for a video with licensed music; show thumbnailUrl instead.
thumbnailUrlstring | null- A video story's cover image. Null for images.
permalinkstring | null- The story on Instagram. It opens only while the story is live.
timestampdate-time- When the story was posted.
expiresAtdate-time- When the story stops being live, 24 hours after timestamp.
Only live stories
Instagram keeps a story for 24 hours, and so does this list. Media URLs stop working when the story expires, so copy anything you want to keep. Live video broadcasts and stories reshared from other accounts are never included.
The account needs the basic read permission that every Instagram connection
has. An account with no live stories returns "stories": [].
Errors — 401 unauthorized, 400 invalid_request, 404 profile_not_found,
404 account_not_found, 403 permission_required with missing permission and
reconnect details, 422 connection_expired, 502 provider_error.