Release
November 16, 2026
Send new photos and videos in messages, with a step-by-step Uploading Media guide. Scheduled posts now wait for their time. And these docs can now be read by AI assistants.
Current plan
Uploading now uses one permission, Upload Media, in place of three. Roles that had Create Signed Media Upload have been given it. If an upload step answers 403, ask an admin to tick Upload Media on your key's role under Public API → Roles.
Send new photos and videos
Every step of sending a new photo or video, in a message or a mass message, now goes through the API, except sending the file itself, which goes straight to the upload address you're given.
The new Uploading Media guide walks through them all, from checking whether the vault already has the file to tagging the creators in it. Each step below links to its own page.
- Check the vault first. Lookup Vault Media by Hash tells you whether the vault already has the file, so you never upload it twice.
- Upload it. Create Signed Upload now needs just the file's name, size and type. Files over 5 MB go up in pieces, which Finish Multipart Upload joins.
- Get it ready. New: Convert Upload makes the file ready to send, with the account's upload settings and watermark applied.
- Send it. Put the file in
mediaFilesof Send Message or Send Mass Message. New files and vault files can go in the same message. - Keep it in the vault. A new file reaches the vault only once it's sent. To store files without leaving them in a chat, send them in a free message, then unsend it. The guide shows how.
- Tag creators. New: Attach Tags To Vault Media tags the creators, guests and partners who appear in a vault file.
- Uploads that stopped working in October. OnlyFans changed how uploads work in October. If yours started failing, follow the steps in the guide: get each file ready with Convert Upload, using the
keyanduploadTokenfrom Create Signed Upload.
One permission for uploading
Every upload step now needs one permission: Upload Media, in the Media group under Public API → Roles in the FansMetric app. It covers checking the vault, uploading, joining pieces, getting the file ready and tagging creators.
- It replaces three old permissions: Lookup Media by Hash, Create Signed Media Upload and Finish Signed Media Upload. Those are gone from the role form.
- Roles that had Create Signed Media Upload have been given Upload Media, so most keys need no change.
- A role that had only Lookup Media by Hash has no upload permission now, and gets
403on every upload step. An organization admin fixes it by ticking Upload Media on that role. - Every upload page names the permission it needs, as
api_media_upload.
Scheduled posts wait for their time
A post meant for later could go out straight away. Now it waits for its time. Send scheduledDate to Create Post: the time in UTC, such as 2026-11-20T15:00:00.000Z. scheduledTime, the name that page used to give, now works too, so if you used it, nothing needs changing.
scheduledDateis all you need to send. Nothing else has to be set to schedule a post.- Save for later. To put a post in OnlyFans' Saved for later queue instead, send
isScheduled: 1andisPublishedWithPeriod: 1, with noscheduledDate. - Check it's queued. The answer's
postedAtis the time you chose. To be sure the post is waiting and not live, find it in List Later Scheduled Posts.
Use these docs with an AI assistant
These docs now come in a plain-text form that AI assistants and coding tools read well. Give your assistant one of these links, then ask it about the API or have it help write a request.
- llms.txt: a short map of every page, with a link to each.
- llms-full.txt: every page in one file.
- One page on its own: put
/mdbefore its address and.mdafter, such as /md/uploading-media.md. - Search engines and AI tools can now find every page of these docs.
Docs improvements
These change the pages only.
- Endpoint notes are back. Each endpoint's notes, such as its limits, defaults and what to watch for, had been hidden. They now show under Behavior on every endpoint page that has them.
- Easier to read. The text under each page title stands out more, and the endpoint notes match its size.
- Send Mass Message now gives each field's default, so you can see what happens when you leave one out. It no longer says guests and partners can't be tagged: they always could, with
rfGuestandrfPartner. - Send Message and Create Post no longer list fields you never need to send.
- Broken links fixed on Get Chat Message, Bulk Add Users To List and Clear User List.