Create Story
Create a story in a newsroom. Content starts as a draft; publishing is a separate action.
Personal token scopes: stories:write. Your account must also have access to the requested data. Authentication
Create a draft using an explicit format version. Rich content is JSON-encoded inside the request, not a parsed document. Formats 4–6 store title, subtitle and header image in content.
Personal access tokens: stories:write. Every listed scope is required; the token owner's permissions, feature availability and newsroom access still apply.
API_keyAuthorizationBearer <token>Bearer authentication using an integration API key, or a personal access token only where the operation explicitly supports it. Every listed personal-token scope is required; owner permissions and newsroom access still apply.
Accept?stringUse the content-format field to request a conversion
application/json; [content-format=(v1|v3|v4|v5|v6)]"application/json"application/json- body
newsroom?|||Newsroom numeric ID or UUID, either directly or in a single-key object.
culture?LocaleCodeLanguage code (ISO 639-1 or ISO 639-2), with optional script designator (ISO 15924) and optional region code (ISO 3166-1).
[a-z]{2,3}(_[A-Z][a-z]{3})?(_[A-Z]{2})?2 <= lengthcategories?array<number>List of Newsroom Categories ids
tags?array<string>visibility?string"public""embargo""private""confidential"published_at?stringdate-timeformat_version?integerStored story format. Omission uses the account default; set explicitly when preparing content. The Accept header independently selects response conversion.
13456title?stringOnly accepted for formats 1 and 3. For formats 4–6 this belongs inside the content document and is rejected as a top-level field.
subtitle?stringOnly accepted for formats 1 and 3. For formats 4–6 this belongs inside the content document and is rejected as a top-level field.
intro?stringOnly available for HTML stories (format_version = 1)
content?||For format 1, an HTML string. For formats 3–6, serialized content input; use document version 2.6 with format 6.
header_image?stringOnly accepted for formats 1 and 3. For formats 4–6 this belongs inside the content document and is rejected as a top-level field.
preview_image?Object containing info about an uploaded image.
See Images and Files on how to handle images.
custom_slug?stringsocial_text?stringsocial_image?Object containing info about an uploaded image.
See Images and Files on how to handle images.
is_shared_to_prpro?booleanCreated
application/json- response
story*Extended Story object containing additional "heavy" properties that are not included into normal Story objects returned from listing API.
curl -X POST 'https://api.prezly.com/v2/stories' \ -H 'Content-Type: application/json' \ -d '{}'{ "story": { "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "id": 0, "thumbnail_url": "http://example.com", "title": "string", "subtitle": "string", "intro": "string", "culture": { "code": "en", "name": "string", "direction": "ltr", "language_code": "en", "native_name": "string" }, "slug": "string", "format_version": 1, "language": "string", "status": "uninitialized", "lifecycle_status": "uninitialized", "publication_status": "uninitialized", "visibility": "private", "is_archived": true, "is_finalized": true, "is_published": true, "is_draft": true, "is_embargo": true, "is_private": true, "is_scheduled": true, "is_analytics_available": true, "is_sharable": true, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "published_at": "2019-08-24T14:15:22Z", "scheduled_at": "2019-08-24T14:15:22Z", "author": { "id": 0, "email": "http://example.com", "name": "string", "display_name": "string", "first_name": "string", "last_name": "string", "avatar_url": "http://example.com" }, "newsroom": { "id": 0, "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "name": "string", "display_name": "string", "subdomain": "string", "thumbnail_url": "http://example.com", "timezone": "europe/london", "is_active": true, "is_archived": true, "is_online": true, "is_offline": true, "is_multilingual": true, "url": "http://example.com", "links": { "media_gallery_api": "http://example.com", "room_contacts_api": "http://example.com", "analytics_and_visibility_settings": "http://example.com", "categories_management": "http://example.com", "company_info_settings": "http://example.com", "contacts_management": "http://example.com", "domain_settings": "http://example.com", "edit": "http://example.com", "gallery_management": "http://example.com", "hub_settings": "http://example.com", "languages": "http://example.com", "look_and_feel_settings": "http://example.com", "manual_subscription_management": "http://example.com", "privacy_settings": "http://example.com", "widget_settings": "http://example.com" } }, "oembed": { "url": "http://example.com", "type": "video", "version": "1.0", "title": "string", "description": "string", "author_name": "string", "author_url": "http://example.com", "provider_name": "string", "provider_url": "http://example.com", "cache_age": 0, "html": "string", "thumbnail_url": "http://example.com", "thumbnail_width": 1, "thumbnail_height": 1, "screenshot_url": "http://example.com" }, "links": { "api": "string", "preview": "string", "edit": "string", "sharing": "string", "duplicate": "string", "translate": "string", "analytics": "string", "delete": "string", "publication_api": "string", "reports_api": "string", "short": "string", "newsroom_view": "http://example.com", "newsroom_preview": "http://example.com" }, "categories": [ { "id": 0, "display_name": "string", "display_description": "string", "i18n": { "[a-z]{2,3}(_[A-Z][a-z]{3})?(_[A-Z]{2})?": { "name": "string", "description": "string", "slug": "string", "locale": { "code": "en", "name": "string", "direction": "ltr", "language_code": "en", "native_name": "string" } } }, "stories_number": 0 } ], "translations": [ { "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "id": 0, "thumbnail_url": "http://example.com", "title": "string", "culture": { "code": "en", "name": "string", "direction": "ltr", "language_code": "en", "native_name": "string" }, "language": "string", "status": "uninitialized", "lifecycle_status": "uninitialized", "publication_status": "uninitialized", "visibility": "public", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "published_at": "2019-08-24T14:15:22Z", "scheduled_at": "2019-08-24T14:15:22Z", "author": { "id": 0, "email": "http://example.com", "name": "string", "display_name": "string", "first_name": "string", "last_name": "string", "avatar_url": "http://example.com" }, "newsroom": { "id": 0, "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f", "name": "string", "display_name": "string", "subdomain": "string", "thumbnail_url": "http://example.com", "timezone": "europe/london", "is_active": true, "is_archived": true, "is_online": true, "is_offline": true, "is_multilingual": true, "url": "http://example.com", "links": { "media_gallery_api": "http://example.com", "room_contacts_api": "http://example.com", "analytics_and_visibility_settings": "http://example.com", "categories_management": "http://example.com", "company_info_settings": "http://example.com", "contacts_management": "http://example.com", "domain_settings": "http://example.com", "edit": "http://example.com", "gallery_management": "http://example.com", "hub_settings": "http://example.com", "languages": "http://example.com", "look_and_feel_settings": "http://example.com", "manual_subscription_management": "http://example.com", "privacy_settings": "http://example.com", "widget_settings": "http://example.com" } }, "url": "http://example.com", "oembed": { "url": "http://example.com", "type": "video", "version": "1.0", "title": "string", "description": "string", "author_name": "string", "author_url": "http://example.com", "provider_name": "string", "provider_url": "http://example.com", "cache_age": 0, "html": "string", "thumbnail_url": "http://example.com", "thumbnail_width": 1, "thumbnail_height": 1, "screenshot_url": "http://example.com" }, "slug": "string" } ], "coverage_number": 0, "images_number": 0, "videos_number": 0, "last_coverage_at": "http://example.com", "tag_names": [ "string" ], "content": "string", "header_image": "string", "preview_image": "string", "social_image": "string", "social_text": "string", "thumbnail_image": "string", "referenced_entities": { "stories": { "<uuid>": { "url": "http://example.com", "type": "video", "version": "1.0", "title": "string", "description": "string", "author_name": "string", "author_url": "http://example.com", "provider_name": "string", "provider_url": "http://example.com", "cache_age": 0, "html": "string", "thumbnail_url": "http://example.com", "thumbnail_width": 1, "thumbnail_height": 1, "screenshot_url": "http://example.com" } } }, "content_version": 0 }}