Skip to Content
FanConvert Docs
REST API

Authentication and permissions

The Authorization Bearer fc_sk_ header, what a key sees, and the list of permissions.

1 min readOpen in ChatGPTOpen in Claude

Every request carries the key in the Authorization: Bearer fc_sk_… header. A key:

  • belongs to one person in the organization, who must be an admin;
  • only sees the creators chosen when it was created (any other answers 404, as if she did not exist);
  • only has the permissions chosen (a missing permission answers 403 and names it);
  • expires (7, 30 or 90 days) and can be revoked at any time in Settings › API & MCP: revocation applies from the next request;
  • is the same as the MCP server's: one key system.

Keys created before 7 November 2026 start with fc_pat_: they are still accepted.

REST API permissions

PermissionWhat it opens
creators:readcreators
conversations:readMYM and OnlyFans conversations and messages
telegram:readTelegram conversations and messages
fans:reada fan's labels and team note
chatting:readwho answers a fan (AI, a person, paused)
sales:readsales
statistics:readstatistics per creator
scripts:read · media:readsales scripts, media library
notifications:reademergencies
fans:writewrite the team note and add/remove a label (with fans:read)
chatting:writepause the AI on a fan, or hand the fan back (with chatting:read)
webhooks:read · webhooks:writelist and create webhooks

No permission allows sending a message to a fan.

Personal data

The API only returns what the dashboard already shows an admin: fan names, messages, notes. Treat them as personal data: minimal storage, restricted access, deletion when you no longer need them.

Last updated on

On this page