Create a new post

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

Post text is checked for prohibited language and rejected with a 400 if it does not pass.

post/posts

Request

Base URL
https://api.fanvue.com
URL
https://api.fanvue.com/posts
Auth
OAuth 2
Authorization code: https://auth.fanvue.com/oauth2/auth
Token URL: https://auth.fanvue.com/oauth2/token scopes: write:post

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