1. stories
api
  • auth
    • ouath
      • Login app
      • redirect
      • callback
    • accounts
      • Get Account
      • Account Delete
      • Account Preference Setttings Update
      • Account Profile Update
      • Account Deactivate
    • sessions
      • Get All Session
      • Delete Sessions
    • devices tokens
      • Create Device Tokens
    • Email Login
      POST
    • Check already account exists
      POST
    • New Account Register
      POST
    • Send OTP
      POST
    • Validate OTP email or phone
      POST
    • Refresh Tokens
      POST
    • Auth Logout
      POST
    • /auth/reset-password
      POST
    • New Password Set
      PUT
    • Password Change
      PUT
    • Email Verify
      POST
  • feed
    • Feed
      GET
  • stories
    • Create a new story
      POST
    • Get stories from friends/followers/public
      GET
    • Get a single story
      GET
    • Delete Story
      DELETE
  • analytics
  • comments
    • List User Comments
      GET
    • Create a Comment
      POST
    • Delete a Comment
      DELETE
    • Update a Comment
      PUT
    • replies
      GET
  • message
    • List all messages
    • Create a Message
    • Create a Message Reply
    • Add Emoji to Message
  • notifications
    • List all notifications
    • Mark Notification as Read
    • Delete Notification
    • Delete all notification
  • interests
    • interests
  • multipart uplaods
    • Create Multipart Uplaod
    • GetUploadedParts
    • CompleteMultipartUpload
    • AbortMultipartUpload
    • SignPartUpload
  • friends
  • admin
    • auth
      • Admin Login
      • me
  • music
    • Create music
    • Delete music
  • users
    • User Lists
    • get user by username
    • User Follow
    • User Follow Unfollow
    • Get User Followers
    • Get User following
    • Get User Friends
  • posts
    • Create Draft Post
    • Update Posts
    • Destory Post
  • places
    • places
    • Single Place
  • hashtags
    • hashtags
    • hashtags trendings
    • Single HashTag
  • reactions
    • reactions
  • reports
    • Reports
  • Welcome
    GET
  • Untitled Endpoint
    POST
  • cdn
    GET
  1. stories

Create a new story

Developing
POST
/stories
•type → "text", "image", "video", or "music" (required)
•media_id → only for image/video stories
•music_id → only for music stories
•background_style → only for text stories
•metadata → optional stickers, polls, etc.
•privacy → "public", "friends", "private", etc.
•is_highlight → true if you want to save it as a permanent highlight

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/stories' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "type": "text", // video,text,image
    "caption": "Sunset vibes 🌅",
    "media_id": null,
    "music_id": null,
    "background_style": {
        "type": "gradient",
        "colors": [
            "#FF5F6D",
            "#FFC371"
        ]
    },
    "privacy": "friends"
}'
Response Response Example
{}
Modified at 2025-10-25 15:45:35
Previous
Feed
Next
Get stories from friends/followers/public
Built with