Skip to main content
POST
Create a new post
Required scope
  • write:post — Create, edit, and manage posts and content on behalf of users.

Authorizations

Authorization
string
header
required

OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.

Headers

X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Body

application/json
audience
enum<string>
required

Audience that can view the post

Available options:
subscribers,
followers-and-subscribers
text
string

Text content of the post

Maximum string length: 5000
mediaUuids
string<uuid>[]

Array of media UUIDs to attach to the post

mediaPreviewUuid
string<uuid>

UUID of free preview media shown before unlock

price
number

Price in cents for paid posts (requires media)

Required range: x >= 300
publishAt
string<date-time>

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

expiresAt
string<date-time>

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

collectionUuids
string<uuid>[]

Array of content collection UUIDs to assign to the post

Response

Post created successfully

uuid
string<uuid>
required

Unique identifier of the created post

createdAt
string<date-time>
required

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

text
string | null
required

Text content of the post

price
number | null
required

Price in cents for paid posts

mediaPreviewUuid
string<uuid> | null
required

UUID of free preview media

audience
enum<string>
required

Audience that can view the post

Available options:
subscribers,
followers-and-subscribers
publishAt
string<date-time> | null
required

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

publishedAt
string<date-time> | null
required

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

expiresAt
string<date-time> | null
required

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