Trial Links

Create Trial Link

Creates a trial link on OnlyFans and stores it in the FansMetric database. Requires permission api_trial_links_create.

https://public-api.fansmetric.com

POST/v1/{account_id}/trial-links

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

account_id*integer
OnlyFans numeric account ID.

Request Body

application/json

name*string
Trial link name.
subscribe_days*string
Trial duration in days. Valid: 1, 3, 7, 14, 30, 90, 180, 360.
subscribe_countsstring
Max claims. 0 = unlimited. Default 0.
expire_daysstring
Days until link expires. 0 = no expiry.
tag_idsarray
FansMetric tag IDs.
custom_source_urlstring
Custom source URL.

curl --request POST "https://public-api.fansmetric.com/v1/acct_XXXXX/trial-links" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "name": "1 Month Free Trial",
  "subscribe_days": 30,
  "subscribe_counts": 100,
  "expire_days": 7,
  "tag_ids": [1, 2],
  "custom_source_url": "https://reddit.com/r/example"
}'

Response

201

{"data":{"id":100000021
"trialLinkName":"1 Month Free Trial"
"url":"https://onlyfans.com/creator_XXXXX/trial/XXXXXXXXXXXXXXXXXXXXXXXXX"
"subscribeDays":30
"subscribeCounts":100
"claimCounts":0
"expiredAt":null
"createdAt":"2026-05-15T10:00:00+00:00"
"isFinished":false
"fmTags":[0:{"id":1
"name":"Reddit"
"color":"#FF5733"
"created_at":"2026-01-12T09:14:22Z"
}
1:{"id":2
"name":"Twitter"
"color":"#1DA1F2"
"created_at":"2026-01-12T09:15:01Z"
}
]
"fmCustomSourceUrl":"https://reddit.com/r/example"
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Get Trial Link

Delete Trial Link