Sign in

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.

post/tracking-links

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Request body

namestring required

Name of the tracking link

externalSocialPlatform'facebook' | 'instagram' | 'other' | 'reddit' | 'snapchat' | 'tiktok' | 'twitter' | 'youtube' required

Social platform

Response

Tracking link created successfully

uuidstring uuid required

Tracking link UUID

namestring required

Name of the tracking link

linkUrlstring required

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

externalSocialPlatform'facebook' | 'instagram' | 'other' | 'reddit' | 'snapchat' | 'tiktok' | 'twitter' | 'youtube' required

Social platform

createdAtstring date-time required

When the link was created

clicksnumber required

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.

Changes

No recorded changes to this endpoint across all 2 revisions of this API.