Sign in
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.

mediaFilesstring

Array of OFAPI ofapi_media_ IDs, or OF media IDs

previewsstring[]

Array of media file upload prefixed_ids, or OF media IDs (required if price is not 0). Will be shown if price is provided. All previews values must also exist in the mediaFiles array.

rfTagstring

Array OnlyFans creator user IDs to tag in your post

expireDaysinteger

Number of days after which the post will expire. Can be 1, 3, 7 or 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!",
  "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
    }
  }
}

Changes