Fansly API LogoFansly API
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*
string
The unique identifier for the connected account.

Request Body

userId*
string
The unique identifier (userId) of the fan to add to the list.
listId*
string
The 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

FieldTypeDescription
statusCodenumberThe HTTP status code of the response (e.g., 200)
messagestringA human-readable message about the result
dataobjectThe main response payload
├─ status_codenumberThe internal status code of the Fansly operation
└─ dataobjectNested data container
├─ successbooleanIndicates whether the request was successful
└─ responseobjectThe fan/list pair that was added
├─ idstringThe unique identifier (userId) of the fan that was added
├─ listIdstringThe unique identifier of the list the fan was added to
├─ typenumberThe type of the list.
└─ metadatastringThe metadata of the list.
timestampstringThe ISO 8601 timestamp of when the response was generated

On this page