Skip to main content

How to Create a Story

Stories are temporary posts that disappear after 24 hours. Follow these steps to create one in the app or via the API.

In the app (UI)​

  1. Open the app and log in.
  2. At the top of the feed, find the stories row (e.g. "Post a Story" or your avatar with a "+").
  3. Click Create Story or the + on your story ring.
  4. Choose Photo/Video or Text:
    • Photo/Video: Select a file from your device, add an optional caption, then post.
    • Text: Type your text, pick a background color if available, then post.
  5. Set privacy (who can see it) if the option is shown.
  6. Publish. Your story will appear in the stories row and expire after 24 hours.

Via the API​

With media (image or video):

POST /api/Story/users/{userId}
Authorization: Bearer {token}
Content-Type: multipart/form-data

FormData: media (file), type (image|video), privacy (public|friends|custom)

Text-only story:

POST /api/Story/users/{userId}
Authorization: Bearer {token}
Content-Type: application/json

{
  "content": "Check out my day!",
  "type": "text",
  "backgroundColor": "#FF5733"
}

Next steps​