Register the creator’s personal notification chat
Stores a Telegram chat id as the creator's **personal** notification target — the DM their sale notifications go to.
/api/external/register-telegram-chatStores a Telegram chat id as the creator's personal notification target — the DM their sale notifications go to.
Unlike add-group, the id is not verified against Telegram — a wrong id silently breaks the creator's notifications until corrected. Prefer letting the creator connect through the Dropfans dashboard; use this only when your app already knows the correct chat id (e.g. the creator is talking to your bot).
The same fields power the creator's own Dropfans → Telegram sale notifications. Changing them here changes where the creator's notifications go — including notifications your app has nothing to do with. Only call this when the creator explicitly asked for it.
Authentication
Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.
Request body
Content type: application/json
| Name | Type | Required | Description |
|---|---|---|---|
telegramChatId | string | Required | The Telegram chat id of the creator’s DM with the notification bot. Stored as-is, unverified. |
{
"telegramChatId": "123456789"
}Responses
| Name | Type | Description |
|---|---|---|
success | boolean | Always true. |
{
"success": true
}Errors
| Status | Body | When |
|---|---|---|
| 400 | {"error":"Invalid JSON body"} | The body is not valid JSON. |
| 400 | {"error":"telegramChatId is required and must be a string"} | Missing or non-string chat id. |
| 401 | {"error":"Unauthorized","code":"unauthorized"} | Missing or invalid API key. |
Rate limiting
Every response carries the X-RateLimit-Tier header and, on limited tiers, the per-minute and per-day trios — read X-RateLimit-Remaining and X-RateLimit-Reset instead of hardcoding limits. Details in Rate limits.
Code samples
curl -X POST "https://www.dropfans.io/api/external/register-telegram-chat" \
-H "Authorization: Bearer $DROPFANS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"telegramChatId": "123456789"
}'const res = await fetch(`https://www.dropfans.io/api/external/register-telegram-chat`, {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"telegramChatId": "123456789"
}),
});
console.log(await res.json());import os
import requests
res = requests.post(
"https://www.dropfans.io/api/external/register-telegram-chat",
headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
json={
"telegramChatId": "123456789",
},
)
print(res.json())Questions? [email protected]