NewFans API, previously OnlyFans API ยท A new name. A broader platform.
Fans API
FanslyMass Messaging

Create Mass Message Audience

Create a broadcast group โ€” the audience a mass message is sent to โ€” and get its id to use as groupId with the Send Mass Message endpoint. This is what the Fansly dashboard does when you pick recipients for a new mass message and press Next; it does not send anything.

Choose recipients by status (followers, subscribersAutoRenewOn, subscribersAutoRenewOff, expiredSubscribers) and/or by list (includeListIds), then narrow them with excludeListIds, excludeUserIds, excludeCreators, and excludeOffline. At least one recipient source is required.

Every call creates a new group, so create an audience once and reuse its groupId for later sends rather than creating one per message.

POST
/api/fansly/{fanslyAccount}/mass-messaging/audiences
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

fanslyAccount*string

The Fansly Account ID

Request Body

application/json

followers?boolean

Include followers who are not subscribed.

subscribersAutoRenewOn?boolean

Include active subscribers with auto-renew on.

subscribersAutoRenewOff?boolean

Include active subscribers with auto-renew off.

expiredSubscribers?boolean

Include expired subscribers.

subscriptionTierId?string

Only include subscribers of this subscription tier (from the List Subscription Tiers endpoint). Requires subscribersAutoRenewOn or subscribersAutoRenewOff.

includeListIds?array<string>

Include the members of these lists (from the List Lists endpoint).

excludeListIds?array<string>

Exclude the members of these lists.

excludeUserIds?array<string>

Fansly user IDs to exclude.

excludeCreators?boolean

Skip other creators who are not subscribed to you. Defaults to true, as on the Fansly dashboard.

excludeOffline?boolean

Skip users who are offline.

Response Body

application/json

curl -X POST "https://app.fansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/mass-messaging/audiences" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": {
    "users": [
      {
        "userId": "800000000000000001",
        "permissionFlags": 65535,
        "groupId": "200000000000000030"
      },
      {
        "userId": "900000000000000001",
        "permissionFlags": 0,
        "groupId": "200000000000000030"
      }
    ],
    "recipients": [],
    "lastMessage": null,
    "userSettings": null,
    "type": 3,
    "groupFlags": 16,
    "groupFlagsMetadata": "",
    "createdBy": "800000000000000001",
    "id": "200000000000000030",
    "permissionFlags": []
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 10055789,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 5000,
      "limit_day": null,
      "remaining_minute": 4999,
      "remaining_day": null,
      "notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
    }
  }
}