Stories

Create a story

Create a story

post/api/v1/stories

Request

  • Base URL: https://storylayer.ai
  • URL: https://storylayer.ai/api/v1/stories
  • Auth: HTTP bearer

Request body

projectIdstring uuid

Required when token is user-scoped

titlestring
captionstring required
channelsstring[]
hashtagsstring

Space-separated hashtags

media_urlstring uri
media_urlsstring[]
post_type'single' | 'carousel' | 'reel' | 'story'
scheduled_atstring date-time

ISO 8601 with offset

scheduled_at_localstring

Local time without offset, e.g. 2026-06-18T09:00:00

timezonestring

IANA timezone, e.g. America/New_York

channel_overridesobject

Example request

{
  "projectId": "00000000-0000-0000-0000-000000000001",
  "caption": "New listing at 14B Vine Street — 3 bed, mountain views.",
  "channels": [
    "instagram",
    "facebook"
  ],
  "media_url": "https://cdn.example.com/listing.jpg",
  "scheduled_at_local": "2026-06-19T09:00:00",
  "timezone": "America/Denver"
}

Response

Success

enqueueobject

Changes

No recorded changes to this operation across all 1 revision of this API.