Fansly API LogoFansly API
Chat messages

Read Receipts

Enable or disable read receipts for a specific chat.

Enable or disable read receipts for a specific chat group. When enabled, the other participant will be able to see when you have read their messages.

https://v1.apifansly.com/api/fansly
POST
/{account_id}/chats/{chat_id}/readreceipts

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}/chats/{chat_id}/readreceipts" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "enable"
  }'
fetch("https://v1.apifansly.com/api/fansly/{account_id}/chats/{chat_id}/readreceipts", {
  method: "POST",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "action": "enable"
  })
})
import requests

url = "https://v1.apifansly.com/api/fansly/{account_id}/chats/{chat_id}/readreceipts"
headers = {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "action": "enable" # or "disable"
}

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 jsonPayload = "{\"action\":\"enable\"}";

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://v1.apifansly.com/api/fansly/{account_id}/chats/{chat_id}/readreceipts"))
        .header("x-api-key", "YOUR_API_KEY")
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(jsonPayload))
        .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 payload = new StringContent("{\"action\":\"enable\"}", Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://v1.apifansly.com/api/fansly/{account_id}/chats/{chat_id}/readreceipts", payload);
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}/chats/{chat_id}/readreceipts"
    payload := []byte(`{"action":"enable"}`)

    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.
chat_id*
string
The unique group ID of the chat.

Request Body

action*
string
Set to `"enable"` to turn on read receipts, or `"disable"` to turn them off.

Response

{
    "statusCode": 201,
    "message": "Success",
    "data": {
        "status_code": 200,
        "data": {
            "success": true,
            "response": {
                "groupId": "chat_group_id_string",
                "userId": "user_id_string",
                "sendReadReceipts": 2,
                "updatedAt": 1778623688836
            }
        }
    },
    "timestamp": "2026-05-12T22:08:07.565Z"
}

Response Body

FieldTypeDescription
statusCodenumberThe HTTP status code of the response (e.g., 201)
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
└─ responseobjectDetailed information about the read receipts configuration
├─ groupIdstringThe unique ID of the chat group
├─ userIdstringThe unique ID of the user updating their receipts
├─ sendReadReceiptsnumberThe new read receipts status (2 for enabled, 1 for disabled)
└─ updatedAtnumberUnix timestamp of when the setting was last updated
timestampstringThe ISO 8601 timestamp of when the response was generated

On this page