Skip to main content
Learn how to create posts on OnlyFans using the OFAuth API, including adding media, scheduling, PPV pricing, and polls.

Prerequisites

You have a connected OnlyFans account with a valid connectionId
Media uploaded to vault (see Upload Media) if including images/videos

Create a Simple Text Post


Create Post with Media

Include images or videos in your post:
For all accepted mediaItems values (vault IDs, upload references, URLs) and validation rules, see the mediaItems reference.

Create a PPV (Pay-Per-View) Post

Lock content behind a paywall:

PPV Options


Schedule a Post

Create a post to publish later:
Scheduled posts are stored in OnlyFans’ queue. Use an ISO 8601 date string for scheduledDate.

Create a Poll Post

Attach a poll to a managed post request:

Poll Options

OFAuth maps the managed poll object to OnlyFans’ upstream poll fields automatically. You do not need to send raw votingOptions, votingType, or votingDue.

Create Expiring Post

Post that auto-deletes after a set period:

Create Fundraising Post

Create a post with fundraising goal:

Text Formatting

Posts support markdown formatting:
See Text Formatting Guide for the full formatting reference.
Supported:
  • **bold** → bold
  • *italic* → italic
  • \n\n → New paragraph

Edit an Existing Post

Update a post’s content:

Delete a Post


Complete Example

Full workflow: upload media, then create post:

All Post Options

These options also apply to POST /v3/access/posts and post edits (PATCH /v2/access/posts/{postId} and PUT /v3/access/posts/{postId}). List available post labels with GET /v2/access/labels?limit=10&offset=0 or GET /v3/access/labels?limit=10. Each label includes id, name, type, and postsCount. Both endpoints require posts:read. V2 returns list, hasMore, and nextOffset; pass nextOffset as the next request’s offset. V3 returns items and page; pass page.nextCursor as cursor while page.hasMore is true. To label a scheduled post, send a create request with both labelIds and scheduledDate:
Use a custom label ID from the creator’s label list. OnlyFans returns the applied labels in the post’s labelStates.

Next Steps

Upload Media

Learn the full media upload flow

Send Message

Share content via DM