Create a tracking link for a creator | Fanvue API Documentation

import requests
url = "https://api.fanvue.com/creators/creatorUserUuid/tracking-links"
payload = {
    "name": "string",
    "externalSocialPlatform": "facebook"
}
headers = {
    "X-Fanvue-API-Version": "2025-06-26",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "uuid": "d4e5f6g7-8h9i-0j1k-2l3m-n4o5p6q7r8s9",
  "name": "TikTok Profile",
  "linkUrl": "fv-123456",
  "externalSocialPlatform": "tiktok",
  "createdAt": "2024-01-15T00:00:00.000Z",
  "clicks": 0,
  "engagement": {
    "acquiredSubscribers": 0,
    "acquiredFollowers": 0
  },
  "earnings": {
    "totalGross": 1.1,
    "totalNet": 1.1
  }
}

Create a new tracking link for the specified creator.

Scope required: write:tracking_links write:creator

Create a new tracking link for the specified creator. <Info>Scope required: `write:tracking_links` `write:creator`</Info>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

Request

This endpoint expects an object.

namestringRequired>=1 character

Name of the tracking link

externalSocialPlatformenumRequired

Social platform

Response

Tracking link created successfully

uuidstringformat: "uuid"

Tracking link UUID

namestring

Name of the tracking link

linkUrlstring

Tracking link URL (e.g., ‘fv-123’)

externalSocialPlatformenum

Social platform

createdAtstringformat: "date-time"

When the link was created

clicksdouble

Number of clicks on this link

engagementobject

Engagement metrics from this tracking link

earningsobject or null

Earnings from this tracking link (null for newly created links)

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

410

Gone Error