Lists
Add Fan to List
Add a fan to a specific list.
Add a fan to one of your lists. Useful for segmenting fans into groups, such as VIPs, big spenders, or custom categories, so you can build targeted messaging or engagement workflows around them.
https://v1.apifansly.com/api/fansly
POST
/{account_id}/lists/users
Get Started
All requests to the Fansly API require an API Key. See the Authentication page for details.
curl -X POST "https://v1.apifansly.com/api/fansly/{account_id}/lists/users" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"userId": "fanid",
"listId": "listid"
}'fetch("https://v1.apifansly.com/api/fansly/{account_id}/lists/users", {
method: "POST",
headers: {
"x-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
userId: "fanid",
listId: "listid"
})
})import requests
url = "https://v1.apifansly.com/api/fansly/{account_id}/lists/users"
headers = {
"x-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"userId": "fanid",
"listId": "listid"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpClient client = HttpClient.newHttpClient();
String requestBody = "{\"userId\":\"fanid\",\"listId\":\"listid\"}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://v1.apifansly.com/api/fansly/{account_id}/lists/users"))
.header("x-api-key", "YOUR_API_KEY")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(requestBody))
.build();
client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
.thenApply(HttpResponse::body)
.thenAccept(System.out::println)
.join();using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var jsonBody = "{\"userId\":\"fanid\",\"listId\":\"listid\"}";
var content = new StringContent(jsonBody, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://v1.apifansly.com/api/fansly/{account_id}/lists/users", content);
var responseString = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseString);package main
import (
"bytes"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
url := "https://v1.apifansly.com/api/fansly/{account_id}/lists/users"
payload := []byte(`{"userId":"fanid","listId":"listid"}`)
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(payload))
req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}Path Parameters
account_id*
stringThe unique identifier for the connected account.
Request Body
userId*
stringThe unique identifier (userId) of the fan to add to the list.
listId*
stringThe unique identifier of the list to add the fan to.
Response
{
"statusCode": 201,
"message": "Success",
"data": {
"status_code": 200,
"data": {
"success": true,
"response": [
{
"id": "fan_id_string",
"listId": "listid",
"type": 1,
"metadata": ""
}
]
}
},
"timestamp": "2026-06-16T20:47:42.167Z"
}Response Body
| Field | Type | Description |
|---|---|---|
statusCode | number | The HTTP status code of the response (e.g., 200) |
message | string | A human-readable message about the result |
data | object | The main response payload |
├─ status_code | number | The internal status code of the Fansly operation |
└─ data | object | Nested data container |
├─ success | boolean | Indicates whether the request was successful |
└─ response | object | The fan/list pair that was added |
├─ id | string | The unique identifier (userId) of the fan that was added |
├─ listId | string | The unique identifier of the list the fan was added to |
├─ type | number | The type of the list. |
└─ metadata | string | The metadata of the list. |
timestamp | string | The ISO 8601 timestamp of when the response was generated |