Create a tracking link

Changed on Oct 21, 2026

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

Request

Base URL
https://api.fanvue.com
URL
https://api.fanvue.com/tracking-links
Auth
OAuth 2
Authorization code: https://auth.fanvue.com/oauth2/auth
Token URL: https://auth.fanvue.com/oauth2/token scopes: write: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

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')

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

Oct 21, 2026966260af2770 Revision changes
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status

Operation history