Create a link for a drop, a tip, a subscription or the profile

Creates one link id. The link is https://www.dropfans.io/buy/{id} (web) and https://t.me/<bot>/app?startapp={id} (Telegram), with no parameters. The drop, the tip amount and your externalRef are stored with the id.

• buy: a drop (productId from create-drop) opens its checkout. A subscriber-only drop opens the subscribe sheet instead.
• tip: opens the tip sheet, prefilled with amountUsd when you set one ($5–$750), or the fan picks.
• subscribe: opens the subscribe sheet. profile opens the profile.

externalRef (1–32 of A-Z a-z 0-9 _ -) comes back on the sale: the drop.paid / tip.paid webhooks and GET /orders and /tips, together with the link's linkId. One link per fan per drop is the usual pattern.

The same request always returns the same link, so it's safe to call again. With a key that belongs to an app, sales through the link earn your app owner commission for life, and the call makes your app the account's connected CRM.

{
  "type": "buy",
  "productId": "cmv5tmpcm0015h4oucxkgc4ma",
  "externalRef": "tg_48213377"
}

{
  "type": "tip",
  "amountUsd": 20,
  "externalRef": "tg_48213377"
}

{
  "id": "q7m2c8zk4w",
  "type": "buy",
  "url": "https://www.dropfans.io/buy/q7m2c8zk4w",
  "telegram": "https://t.me/DropfansBot/app?startapp=q7m2c8zk4w",
  "productId": "cmv5tmpcm0015h4oucxkgc4ma",
  "amountUsd": null,
  "externalRef": "tg_48213377",
  "createdAt": "2026-10-29T12:00:00.000Z"
}

curl -X POST "https://www.dropfans.io/api/external/v1/links" \
  -H "Authorization: Bearer $DROPFANS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "buy",
  "productId": "cmv5tmpcm0015h4oucxkgc4ma",
  "externalRef": "tg_48213377"
}'

const res = await fetch(`https://www.dropfans.io/api/external/v1/links`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "buy",
    "productId": "cmv5tmpcm0015h4oucxkgc4ma",
    "externalRef": "tg_48213377"
  }),
});
console.log(await res.json());

import os
import requests

res = requests.post(
    "https://www.dropfans.io/api/external/v1/links",
    headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
    json={
        "type": "buy",
        "productId": "cmv5tmpcm0015h4oucxkgc4ma",
        "externalRef": "tg_48213377",
    },
)
print(res.json())