Skip to main content
Each creator has a small set of switches that control how the AI chatter works for her, plus the OnlyFans welcome message every new subscriber receives. Scopes: 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.
These switches decide whether the AI messages real fans. Turning the AI or follow-ups on lets it start writing to fans; turning review mode off sends the waiting replies right away. Confirm with the person responsible for the creator first.

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.
Send only the fields you want to change. If you echo back 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 for reviewMinutes. 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
Turning review mode off releases the waiting drafts to fans immediately. Drafts that have waited more than about ten minutes are discarded instead of sent (the AI writes a fresh reply to those fans). Because it sends messages, switching review.enabled from on to off:
  • needs both ai:write and messages:send (otherwise 403 INSUFFICIENT_SCOPE naming messages:send);
  • is limited to 6 per hour per creator (429 RATE_LIMITED with Retry-After beyond that).
Sending "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.
This changes what every new subscriber receives and pays for, starting with the next one. Do a dry run first and confirm the exact text, media and price with the person responsible. You can change it at most 5 times per hour per creator, dry runs included.
Response 202

From your AI assistant

With the MCP server connected: β€œIs review mode on for Mia? How many replies are waiting?” uses get_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.