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.
Authorization
default Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
The Fansly Account ID
Request Body
application/json
Include followers who are not subscribed.
Include active subscribers with auto-renew on.
Include active subscribers with auto-renew off.
Include expired subscribers.
Only include subscribers of this subscription tier (from the List Subscription Tiers endpoint). Requires subscribersAutoRenewOn or subscribersAutoRenewOff.
Include the members of these lists (from the List Lists endpoint).
Exclude the members of these lists.
Fansly user IDs to exclude.
Skip other creators who are not subscribed to you. Defaults to true, as on the Fansly dashboard.
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."
}
}
}