Stories
Add to Story
Post a new media or vault file to your story.
AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
accountstring
The Account ID
mediaFilesarray<string>
Array of media file upload prefixed_ids, or OF media IDs (required if price is not 0).
Response Body
curl -X POST "https://app.onlyfansapi.com/api/string/stories" \ -H "Content-Type: application/json" \ -d '{ "mediaFiles": [ "ofapi_media_abc123", 1234567890 ] }'{
"data": {
"id": 123,
"userId": 123,
"isReady": false,
"hasPost": false,
"isWatched": false,
"media": [
{
"id": 123,
"type": "photo",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T01:01:01+00:00",
"isReady": false,
"files": {
"full": {
"url": null,
"width": 0,
"height": 0,
"size": 0,
"sources": []
},
"thumb": null,
"preview": null,
"squarePreview": null
},
"duration": 0,
"hasCustomPreview": false
}
],
"createdAt": "2025-01-01T01:01:01+00:00",
"question": null,
"viewersCount": 0,
"viewers": [],
"commentsCount": 0,
"canDelete": true,
"isHighlightCover": false,
"isLastInHighlight": false,
"tipsAmount": "$0",
"tipsAmountRaw": 0,
"tipsCount": 0,
"likesCount": 0,
"releaseForms": []
},
"_meta": {
"_credits": {
"used": 1,
"balance": 1000999771,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4995,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}