Prerequisites
You have a connected OnlyFans account with a valid
connectionIdMedia 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:**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 toPOST /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:
labelStates.
Next Steps
Upload Media
Learn the full media upload flow
Send Message
Share content via DM