curl --request POST \
--url https://api.fanvue.com/v1/tracking-links \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>' \
--data '
{
"name": "<string>"
}
'import requests
url = "https://api.fanvue.com/v1/tracking-links"
payload = { "name": "<string>" }
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: '<string>'})
};
fetch('https://api.fanvue.com/v1/tracking-links', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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,
"totalSubscribers": 0,
"totalFollowers": 0
},
"earnings": null
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Create a tracking link
Create a new tracking link for the authenticated user.
The response linkUrl is the short slug (for example fv-3); the shareable URL is https://www.fanvue.com/<handle>/<linkUrl>. To attribute a click to a campaign or a record in your own system, append your own query parameters to that URL and read them back from the user-metadata endpoint. See the tracking links guide.
curl --request POST \
--url https://api.fanvue.com/v1/tracking-links \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>' \
--data '
{
"name": "<string>"
}
'import requests
url = "https://api.fanvue.com/v1/tracking-links"
payload = { "name": "<string>" }
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: '<string>'})
};
fetch('https://api.fanvue.com/v1/tracking-links', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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,
"totalSubscribers": 0,
"totalFollowers": 0
},
"earnings": null
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}write:tracking_links— Create and delete tracking links.
Authorizations
OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.
Headers
API version to use for the request
"2025-06-26"
Body
Response
Tracking link created successfully
Tracking link UUID
Name of the tracking link
Tracking link URL (e.g., 'fv-123')
Social platform
facebook, instagram, other, reddit, snapchat, tiktok, twitter, youtube When the link was created
Number of clicks on this link, including clicks that were never matched to an account. This is why the count can exceed the number of users returned by the tracking-link users endpoint, which can only list identified clickers.
Engagement metrics from this tracking link
Show child attributes
Show child attributes
Earnings from this tracking link (null for newly created links)
Show child attributes
Show child attributes
Was this page helpful?