FMFansMetric API

Mass Messages

Send Mass Message

Sends a mass message to selected fan lists and/or individual users. Supports text, media, PPV, GIFs, scheduling, and audience filters. Requires permission api_mass_messages_send.

https://public-api.buffmetrics.com
POST/v1/{account_id}/mass-messages
Bearer

Authorization

default
AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

  • account_id*integer

    OnlyFans numeric account ID.

Request Body

application/json
  • textstring

    Message text (HTML supported). Sent on every call — defaults to empty string when omitted. Required unless mediaFiles or giphyId is set.

  • lockedTextboolean

    Boolean. Hide text behind paywall. Sent on every call — defaults to false when omitted.

  • mediaFilesarray

    Array of integers (vault media IDs). Sent on every call — defaults to [] when omitted.

  • pricestring

    Number. PPV price in USD (0 = free, 3-200 = paid). Sent on every call — defaults to 0 when omitted.

  • previewsarray

    Array of integers (preview media IDs for PPV, must be a subset of mediaFiles). Sent on every call — defaults to [] when omitted.

  • rfTagstring

    Array of integers (release-form creator IDs). Sent on every call — defaults to [] when omitted.

  • rfGueststring

    Array of integers (release-form guest IDs). Always sent — currently forced to [] server-side.

  • rfPartnerstring

    Array of integers (release-form partner IDs). Always sent — currently forced to [] server-side.

  • filtersstring

    Audience filters object. Sent on every call — defaults to {} when omitted. Supported keys: totalSpent, tips, duration, inactive, online, signedUpAfter, signedUpBefore.

  • userListsstring

    Array of list IDs (string for system slugs, integer for custom lists). Only forwarded when non-empty. Required unless userIds is provided. Example: ["fans"], [47382], ["fans", 47382].

  • userIdsstring

    Array of integers (individual user IDs). Only forwarded when non-empty. Required unless userLists is provided.

  • excludedListsstring

    Array of list IDs (string system slug or integer custom ID). Only forwarded when non-empty.

  • recommendersstring

    Integer. Set to 1 to send only to recommended users. Only forwarded when set.

  • giphyIdstring

    String. Giphy GIF ID — get from /v1/gifs/trending or /v1/gifs/search. Only forwarded when set.

  • isScheduledstring

    Integer. Set to 1 to schedule. Only forwarded when set; pairs with scheduledDate.

  • scheduledDatestring

    ISO 8601 timestamp for the scheduled send. Only forwarded when scheduling. Required when isScheduled=1.

curl --request POST "https://public-api.buffmetrics.com/v1/acct_XXXXX/mass-messages" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "text": "Hello everyone!",
  "userLists": ["fans"],
  "mediaFiles": [],
  "price": 0,
  "filters": {}
}'

Response

200
{
"data":{
"id":10000000001
"date":"2026-05-14T18:05:07+00:00"
"isReady":true
"isDone":false
"total":1500
"pending":200
"canUnsend":true
"unsendSeconds":1000000
"hasError":false
"isCanceled":false
"isCouplePeopleMedia":false
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

Mass Message Statistics

Next

List Mass Message Fan Lists