ReferencePosts

Create a new post

Create a new post with optional media, text, and pricing. <Info>Scope required: `write:post`</Info>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

X-Fanvue-API-VersionstringRequiredDefaults to 2025-06-26
API version to use for the request

Request

This endpoint expects an object.
audienceenumRequired
Audience that can view the post
Allowed values:
textstringOptional<=5000 characters
Text content of the post
mediaUuidslist of stringsOptional
Array of media UUIDs to attach to the post
mediaPreviewUuidstringOptionalformat: "uuid"
UUID of free preview media shown before unlock
pricedoubleOptional>=300

Price in cents for paid posts (requires media)

publishAtstringOptionalformat: "date-time"

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

expiresAtstringOptionalformat: "date-time"

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

Response

Post created successfully
uuidstringformat: "uuid"
Unique identifier of the created post
createdAtstringformat: "date-time"

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

textstring or null
Text content of the post
pricedouble or null
Price in cents for paid posts
mediaPreviewUuidstring or nullformat: "uuid"
UUID of free preview media
audienceenum
Audience that can view the post
Allowed values:
publishAtstring or nullformat: "date-time"

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

publishedAtstring or nullformat: "date-time"

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

expiresAtstring or nullformat: "date-time"

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

Errors