latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Create a new post

Create a new post with optional media, text, and pricing.

post/posts

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Request body

textstring

Text content of the post

mediaUuidsstring[]

Array of media UUIDs to attach to the post

mediaPreviewUuidstring uuid

UUID of free preview media shown before unlock

pricenumber

Price in cents for paid posts (requires media)

audience'subscribers' | 'followers-and-subscribers' required

Audience that can view the post

publishAtstring date-time

Future date/time to publish the post (ISO 8601 format)

expiresAtstring date-time

Date/time when the post expires (ISO 8601 format)

collectionUuidsstring[]

Array of content collection UUIDs to assign to the post

Response

Post created successfully

uuidstring uuid required

Unique identifier of the created post

createdAtstring date-time required

Date/time when the post was created (ISO 8601 format)

textstring nullable required

Text content of the post

pricenumber nullable required

Price in cents for paid posts

mediaPreviewUuidstring uuid nullable required

UUID of free preview media

audience'subscribers' | 'followers-and-subscribers' required

Audience that can view the post

publishAtstring date-time nullable required

Future date/time when the post will be published (ISO 8601 format)

publishedAtstring date-time nullable required

Date/time when the post was published (ISO 8601 format)

expiresAtstring date-time nullable required

Date/time when the post expires (ISO 8601 format)