Sign in

v8

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-2526602.8 MB
Posts

Send Post

Compose and send a new post to your OnlyFans account.

post/api/{account}/posts

Request body

textstring required

The post text content

labelIdsstring

Array of OF label IDs. Refer to our /posts/labels endpoint.

rfTagstring

Array OnlyFans creator user IDs to tag in your post

expireDaysinteger

Number of days after which the post will expire. Between 1 and 30 days. Keep empty for no expiration.

scheduledDatestring

Schedule your post in the future (UTC timezone).

saveForLaterboolean

Add your post to the "Saved for later" queue.

fundRaisingTargetAmountinteger

Add a fundraising target to your post. If present, value must be at least 10.

fundRaisingTipsPresetsstring[]

Specify which tip amounts will be listed under the fundraising card. Required with fundRaisingTargetAmount, and you must provide at least 1 option. Array items cannot be higher than the fundRaisingTargetAmount.

votingType'poll' | 'quiz'

Include a poll or quiz within your post.

votingDueinteger

The due date (in days) of your poll/quiz. Can be 1, 3, 7 or 30 days. Can only be filled with votingType.

votingOptionsstring[]

The options of your poll/quiz. Required with votingType.

votingCorrectIndexinteger

The array key of your quiz' correct answer. Required when votingType is "quiz". Keep in mind that arrays start at 0

Example request

{
  "text": "Hello!",
  "mediaFiles": [
    "ofapi_media_abc123",
    "1234567890"
  ],
  "previews": [
    "ofapi_media_abc123",
    1234567890
  ],
  "expireDays": 3,
  "scheduledDate": "2025-01-01T00:00:00.000Z",
  "saveForLater": true,
  "fundRaisingTargetAmount": 30,
  "fundRaisingTipsPresets": [
    5,
    10,
    15
  ],
  "votingType": "poll",
  "votingDue": 3,
  "votingOptions": [
    "First option",
    "Second option"
  ]
}

Response

Success

Example response

{
  "data": {
    "author": {
      "view": "a",
      "avatar": "https://public.onlyfans.com/files/.../avatar.jpg",
      "avatarThumbs": {
        "c50": "https://thumbs.onlyfans.com/public/files/thumbs/.../avatar.jpg",
        "c144": "https://thumbs.onlyfans.com/public/files/thumbs/.../avatar.jpg"
      },
      "header": "https://public.onlyfans.com/files/.../header_image.jpg",
      "headerSize": {
        "width": 4032,
        "height": 3024
      },
      "headerThumbs": {
        "w480": "https://thumbs.onlyfans.com/public/files/thumbs/w480/.../header_image.jpg",
        "w760": "https://thumbs.onlyfans.com/public/files/thumbs/w760/.../header_image.jpg"
      },
      "id": 123,
      "name": "Name",
      "username": "username",
      "canLookStory": true,
      "canCommentStory": true,
      "hasNotViewedStory": false,
      "isVerified": true,
      "canPayInternal": true,
      "hasScheduledStream": false,
      "hasStream": false,
      "hasStories": false,
      "tipsEnabled": false,
      "tipsTextEnabled": true,
      "tipsMin": 5,
      "tipsMinInternal": 1,
      "tipsMax": 200,
      "canEarn": true,
      "canAddSubscriber": false,
      "subscribePrice": 4.99,
      "hasStripe": false,
      "isStripeExist": false,
      "subscriptionBundles": [],
      "canSendChatToAll": true,
      "creditsMin": 10,
      "creditsMax": 200,
      "isPaywallPassed": true,
      "canCreateLists": true,
      "showMediaCount": true,
      "showPostsInFeed": true,
      "subscribedBy": true,
      "canTrialSend": false
    },
    "responseType": "post",
    "id": 123,
    "postedAt": "2025-01-01T01:01:01+00:00",
    "postedAtPrecise": "123.000000",
    "text": "Text",
    "isMarkdownDisabled": true,
    "canDelete": true,
    "canComment": true,
    "canEdit": true,
    "mediaCount": 1,
    "isOpened": true,
    "canToggleFavorite": true,
    "tipsAmount": "$0",
    "rawText": "Text",
    "media": [
      {
        "id": 123,
        "type": "photo",
        "convertedToVideo": false,
        "canView": true,
        "hasError": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "isReady": false,
        "files": {
          "full": {
            "url": null,
            "width": 0,
            "height": 0,
            "size": 0,
            "sources": []
          },
          "thumb": null,
          "preview": null,
          "squarePreview": null
        },
        "duration": 0,
        "releaseForms": [],
        "hasCustomPreview": false
      }
    ],
    "canViewMedia": true
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999991,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 999,
      "remaining_day": 49990
    }
  }
}