Posts

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
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
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