Skip to main content
POST
Create post

Authorizations

Authorization
string
header
required

Link access token for one Sandbox, Test, or Live authorization.

x-linked-account-id
string
header
required

Selects one of the authorization's linked accounts via the x-linked-account-id header.

Headers

x-linked-account-id
string
required

The linked account to use. The user must have shared it with your app. A missing account returns linked_account_required; an account outside your access returns linked_account_not_granted.

Example:

"conn_example123"

Body

application/json
text
string
default:""

Plain text with optional formatting marks. HTML is displayed as text. See Text formatting.

Maximum string length: 10000
replyToMessageId
string | null

Reply to an existing chat message

Minimum string length: 1
mediaItems
(integer | string)[]

Media references to attach. Accepts vault media IDs, upload references (mediaUploadId), or http(s) URLs. See mediaItems reference.

OnlyFans media ID

Required range: x > 0
isLockedText
boolean
default:false

Whether users must pay to read the text (default: false).

price
number | null
default:0

Price to unlock message content (0 for free)

Required range: 0 <= x <= 200
previewMediaCount
integer | null
default:0

Number of mediaItems to show as free previews, starting with the first item.

Required range: x >= 0
releaseForms
object

Release form participants

userTags
integer[]

Users to tag

OnlyFans user ID

Required range: x > 0
isMarkdown
boolean
default:true

Apply formatting marks (default: true). Set false to keep marks as literal text. HTML is displayed as text in both modes. See Text formatting.

scheduledDate

When to publish the post (omit for immediate). Use ISO 8601 with timezone, e.g. 2026-05-25T12:00:00.000Z, or epoch milliseconds.

fundRaisingTargetAmount
number

Target amount for fund raising post

Required range: x >= 10
fundRaisingTipsPresets
number[]

Preset tip amounts for fund raising

Maximum array length: 4
expireAfter
number

Days until post expires (1-30)

Required range: 1 <= x <= 30
poll
object

Poll attached to the post

Response

Successful response

id
number
required
canDelete
boolean
required
canEdit
boolean
required
mediaCount
number
required
media
object[]
required
canViewMedia
boolean
required
responseType
string
required
postedAt
string
required
postedAtPrecise
string
required
isMarkdownDisabled
boolean
required
isOpened
boolean
required
canToggleFavorite
boolean
required
tipsAmount
string
required
text
string
required
isFavorite
boolean
required
canComment
boolean
required
favoritesCount
number
required
isMediaReady
boolean
required
rawText
string
required
author
object