Fanvue API Documentation

curl --request POST \ --url https://api.fanvue.com/creators/{creatorUserUuid}/posts \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'X-Fanvue-API-Version: <x-fanvue-api-version>' \ --data ' { "audience": "subscribers" } '

{ "uuid": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T12:00:00.000Z", "text": "Check out my latest content!", "price": 999, "mediaPreviewUuid": "f1e2d3c4-b5a6-4789-8123-456789abcdef", "audience": "subscribers", "publishAt": null, "publishedAt": "2025-01-01T12:00:00.000Z", "expiresAt": "2025-01-01T12:00:00.000Z" }

Authorizations

Authorization

string

header

required

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

Headers

X-Fanvue-API-Version

string

default:2025-06-26

required

API version to use for the request

Example:

"2025-06-26"

Path Parameters

creatorUserUuid

string<uuid>

required

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)