Create a tracking link

Create a new tracking link for the authenticated user.

Scope required: write:tracking_links

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

AuthorizationBearer

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

This endpoint expects an object.

namestringRequired>=1 character

Name of the tracking link

externalSocialPlatformenumRequired

Social platform

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)

1	curl -X POST https://api.fanvue.com/tracking-links \
2	-H "X-Fanvue-API-Version: 2025-06-26" \
3	-H "Authorization: Bearer <token>" \
4	-H "Content-Type: application/json" \
5	-d '{
6	"name": "string",
7	"externalSocialPlatform": "facebook"
8	}'

1	{
2	"uuid": "d4e5f6g7-8h9i-0j1k-2l3m-n4o5p6q7r8s9",
3	"name": "TikTok Profile",
4	"linkUrl": "fv-123456",
5	"externalSocialPlatform": "tiktok",
6	"createdAt": "2024-01-15T00:00:00.000Z",
7	"clicks": 0,
8	"engagement": {
9	"acquiredSubscribers": 0,
10	"acquiredFollowers": 0
11	},
12	"earnings": {
13	"totalGross": 1.1,
14	"totalNet": 1.1
15	}
16	}