ai:read to read; ai:write to change. Turning review mode off also needs messages:send, because it releases waiting replies to fans.
Read the settings
Response 200
Change settings
PATCH /v1/creators/{creatorId}/ai-settings changes only what you send and returns the full settings. Any other field is refused with 400 VALIDATION_ERROR. Send an Idempotency-Key header to make retries safe.
Follow-ups
Follow-ups are short, in-character nudges to fans who went quiet. They only go out in chats the AI is handling, and they are cancelled in a chat as soon as your team sends a message there.followUps.effective as enabled, you may switch follow-ups off without meaning to while the creatorβs AI is paused.
Review mode
With review mode on, each reply the AI writes waits in the dashboardβs review queue forreviewMinutes. A person approves, edits or discards it there; when time runs out, whenUnreviewed decides (send or hold). Reviewing drafts one by one happens in the dashboard, not the API.
Turn it on for a new creatorβs first days:
cURL
review.enabled from on to off:
- needs both
ai:writeandmessages:send(otherwise403 INSUFFICIENT_SCOPEnamingmessages:send); - is limited to 6 per hour per creator (
429 RATE_LIMITEDwithRetry-Afterbeyond that).
"enabled": false while review mode is already off changes nothing, needs no extra scope and does not count against that limit.
Check review.waitingNow first so you know how many replies will go out:
Python
Welcome message
The welcome message is OnlyFansβ automatic message to every new subscriber of the creator. It can carry text, free media, and paid media with a price. OnlyX reads it from OnlyFans and can replace it for you.Read it
Response 200
Replace it
PUT /v1/creators/{creatorId}/welcome-message (scope ai:write) replaces the whole welcome message on the creatorβs live OnlyFans account. It answers 202 with an updateId; the change is applied within a minute or two.
Response 202
From your AI assistant
With the MCP server connected: βIs review mode on for Mia? How many replies are waiting?β usesget_ai_settings. Changes go through update_ai_settings and update_welcome_message; the assistant shows you the exact change and asks for confirmation first, because both can reach fans.
Related
- Hugo, the AI chatter: what follow-ups and review mode do.
- Creators: the
aiEnabledswitch. - Vault media: media ids for the welcome message.