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 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 Example

{}

Modified at 2025-10-25 15:45:35

Feed

Get stories from friends/followers/public