User Lists

Bulk Add Users To List

Adds many fans to a single custom list in one round trip. Prefer this over calling [Add User to List](/api-reference/user-lists/add-user-to-list) in a loop — one OF call instead of N. Requires permission api_user_lists_bulk_add_members.

https://public-api.fansmetric.com
POST/v1/{account_id}/user-lists/{list_id}/users
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.

  • list_id*integer

    Custom list ID.

Request Body

application/json
  • user_ids*array

    Array of OnlyFans user IDs (integer) to add. Must contain at least one entry.

curl --request POST "https://public-api.fansmetric.com/v1/acct_XXXXX/user-lists/sample_list_id/users" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{ "user_ids": [12345678, 87654321, 11223344] }'

Response

200
{
"data":{
"errors":{
"47382":{
"999999999":[
0:"User not found"
]
}
}
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}