Add Users to User List
Add multiple Users To OnlyFans User List
Authorization
default Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
The Account ID
OnlyFans User List ID, or a default list name like tagged
Request Body
application/json
Array of OnlyFans User IDs to be added into the list
Set to true to skip the User IDs OnlyFans refuses instead of failing the whole batch. We drop the rejected IDs and retry the remainder for you (up to 5 OnlyFans attempts, each costing 1 credit), then respond 200 with data.added (the IDs that made it in) and data.failed (an object mapping each rejected User ID to the reason OnlyFans gave). Note this changes the shape of data — see the example responses. Failures that are not about individual users (e.g. an invalid or inaccessible list ID) still return the regular 400.
Response Body
application/json
application/json
curl -X POST "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/user-lists/1224114714/users" \ -H "Content-Type: application/json" \ -d '{ "ids": [ 123456, 44112233, 22113344 ] }'{
"data": {
"1224114714": [
123456,
44112233,
22113344
]
},
"_meta": {
"_credits": {
"used": 1,
"balance": 224745,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 1000,
"limit_day": 50000,
"remaining_minute": 998,
"remaining_day": 49947
}
}
}{
"error": "ONLYFANS_COM_ERROR",
"message": "Bad Request - The request could not be understood by the server.",
"description": "This error happened most probably because of a bug in the OnlyFans.com API or you sent wrong parameters (like a non-existing user id).",
"onlyfans_response": {
"status": 400,
"body": {
"error": {
"code": 0,
"message": "Unable to add SAMPLE USER to Custom - OFAPI Test"
},
"errors": {
"1224114714": {
"123456": [
"Unable to add SAMPLE USER to Custom - OFAPI Test"
]
}
}
}
},
"_meta": {
"_credits": {
"used": 1,
"balance": 224744,
"note": "OnlyFans returned an error, but we still had to make an API request to OnlyFans.com"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 1000,
"limit_day": 50000,
"remaining_minute": 999,
"remaining_day": 49946
}
}
}