Skip to main content
POST
/
api
/
{account}
/
trial-links
Create Trial Link
curl --request POST \
  --url https://app.onlyfansapi.com/api/{account}/trial-links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": 7,
  "offerExpiration": 7,
  "offerLimit": 7,
  "duration": 7
}'
{
  "data": {
    "id": 123,
    "trialLinkName": "My new trial link",
    "url": "https://onlyfans.com/username/trial/code",
    "subscribeDays": 123,
    "subscribeCounts": 123,
    "claimCounts": 123,
    "expiredAt": "2025-01-05T00:00:00+00:00",
    "createdAt": "2025-01-01T00:00:00+00:00",
    "isFinished": false
  },
  "_pagination": {
    "next_page": null
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999840,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 998,
      "remaining_day": 49993
    }
  }
}

Authorizations

​
Authorization
string
header
required

You can retrieve your token by visiting the OnlyFansAPI Console and clicking API Keys -> Create API Key.

Path Parameters

​
account
string
required

The Account ID

Body

application/json
​
offerExpiration
integer
required

The trial link expiration in days (from now). Must either be 0 (to never expire), or a number between 1 and 30.

Example:

7

​
offerLimit
enum<integer>
required

How many people can use this offer. Must either be 0 (for no limit), or a number between 1-10, 50, or 100.

Available options:
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
50,
100
Example:

7

​
duration
enum<integer>
required

The duration of the free trial in days. Must be 1, 3, 7, 14, 30 (1 month), 90 (3 months), 180 (6 months), or 360 (12 months).

Available options:
1,
3,
7,
14,
30,
90,
180,
360
Example:

7

​
name
string | null

The name of the trail link (optional). Cannot be longer than 64 characters.

Example:

7

Response

200 - application/json

Success

​
data
object
​
_pagination
object
​
_meta
object