Skip to content

Fanvue messaging · Beta

A Fanvue messaging API for chats and DMs

Read every chat on the Fanvue accounts you manage, straight from Fanvue, and send a fan a free or paid message with vault media. Each send is an action with a plain summary in the dashboard, and an AI client that signs in with OAuth waits for your team to approve it.

fanvue-send.sh
curl https://betterfans.link/v1/accounts/$ACCOUNT_ID/actions \
  -H "Authorization: Bearer $BFL_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "send_message",
    "params": {
      "fanId": "2b8f6d1a-5e3c-4a97-8d20-6f1c9e4b7a35",
      "text": "The full cabin clip, thank you for the tip",
      "priceCents": 1500,
      "mediaIds": ["0f6e3b9a-2c7d-4e18-b5a4-8d1c6f9e3b72"]
    }
  }'

# 202 Accepted. Nothing reaches Fanvue until someone approves it:
# "status": "pending",
# "platform": "fanvue",
# "approvalUrl": "https://betterfans.link/approve/act_6TgB2nWq8LkR4vXc9MpZ3hYd"

Fanvue messaging

Read Fanvue chats and send messages

Chats, read live

List an account's chats with unread counts and what each fan has spent. A chat id is the fan id, and every read asks Fanvue.

Message history

Read the messages in any chat, newest first, with the media on each one. Reading a chat never marks it read on Fanvue.

Paid messages

Set priceCents to 300 or more and attach vault media to make a message paid. A paid Fanvue message always carries media.

Mass messages to lists

Send one message to the creator's fan lists, leaving other lists out. Fanvue mass messages go to lists, not to single fans.

Take messages back

Unsend one message, or every copy of a mass message by its massMessageId. Every write carries an Idempotency-Key, so a retry never sends twice.

Typing

Show a fan that the account is typing, right before a reply goes out.

FAQ

Frequently asked questions

Can I send Fanvue messages through an API?

Yes. POST to /v1/accounts/{accountId}/actions with type send_message, the fan id and the text, and the API returns the action with its status. Your key needs the write scope, and writes must be on for the account. AI clients that sign in with OAuth wait for your team to approve each write.

What does a paid Fanvue message need?

Vault media and a price of at least $3. Set priceCents to 300 or more and put media ids from the vault in mediaIds. A free message can be text alone.

Can the API search Fanvue messages?

No. Fanvue has no message search, so Search messages answers not_supported_on_platform for a Fanvue account. Read a chat with List messages instead, or list the chats with unread messages first.

Can I take back a Fanvue mass message?

Yes. Create an unsend_message action with the mass message's massMessageId and no fanId, and every copy is taken back. With a fanId it takes back one message from that fan's chat.

GET STARTED

Build it in test mode today.

Sign up, make a test key and work against sandbox creators. Link a real account when your flow is ready.

Questions first? Write to hello@betterfans.link.