Skip to main content
POST
Create an affiliate link

Authorizations

Authorization
string
header
required

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

Body

application/json

The affiliate link to create

The slug for the new link. Letters, numbers and hyphens only, and unique within the program.

Example:

"summer-campaign"

affiliateId
string<uuid>

The affiliate who will own this link. Required unless affiliateEmail is supplied.

affiliateEmail
string<email>

Email of the affiliate who will own this link. Required unless affiliateId is supplied.

Response

The created affiliate link, with counters at zero and its full URLs already generated.

An affiliate link as returned by the affiliate link endpoints. The counters and fullURLs are computed per request and are not stored on the link itself.

id
string<uuid>

The affiliate link ID

The affiliate link string

createdAt
string<date-time>

Timestamp when the affiliate link was created

updatedAt
string<date-time>

Timestamp when the affiliate link was last updated

affiliate
object | null

The affiliate who owns this link. null if the link has no owner.

program
object | null

The program this link belongs to. null if the link has no program.

clicks
integer

Number of clicks on this affiliate link

referrals
integer

Number of referrals generated by this link

sales
integer

Number of sales generated by this link

totalRevenue
number<float>

Sum of totalEarned across every sale attributed to this link

fullURLs
object[]

One entry per base URL configured on your program, with the affiliate's tracking parameter and any program URL parameters already applied. Share these directly.

Last modified on July 20, 2026