Add to Story
Publish one photo or video to your story. Send exactly one media reference in mediaFiles — a fansly_media_ ID from the Upload Media endpoint, or a Fansly vault media ID (a mediaId from the List Vault Media endpoint). To post several media, call this endpoint once per media.
The media is registered as a new accountMedia for the story, so posting vault media leaves its existing posts and offers untouched. A story is free by default. Gate it with requirePurchase, requireSubscription and requireFollow (all must be met, as on Send Post), or with audiences — a list of alternative audiences, any one of which unlocks the story (e.g. "subscribed, OR pays $5"). audiences also supports private lists and availability windows. Add a free preview with previews.
Fansly decides how long a story stays active; there is no expiry, scheduling or edit option.
Authorization
default Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
The Fansly Account ID
Request Body
application/json
Exactly one media reference: a fansly_media_ upload ID or a Fansly vault media ID.
Require the fan to purchase (unlock) the story. Requires price. Cannot be combined with audiences.
Unlock price for requirePurchase, in Fansly's smallest unit — 1000 = $1.00.
Require the fan to be subscribed. Cannot be combined with audiences.
Restrict requireSubscription to one tier (from List Subscription Tiers). Omit for any tier.
Require the fan to follow the account. Cannot be combined with audiences.
Alternative audiences; a fan meeting every requirement of any one audience can view the story. Each audience needs at least one requirement. Cannot be combined with the top-level gating fields.
A free preview shown while the story is locked, as a map of the mediaFiles reference to the preview media (a fansly_media_ upload ID or a vault media ID).
Response Body
application/json
curl -X POST "https://app.fansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/stories" \ -H "Content-Type: application/json" \ -d '{ "mediaFiles": [ "fansly_media_01JR1234" ] }'{
"data": {
"accountId": "800000000000000001",
"contentType": 1,
"contentId": "979175336375754752",
"id": "979175336988143616"
},
"_meta": {
"_credits": {
"used": 1,
"balance": 10055789,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4999,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}