Smart Links

Create Smart Link

Changed on

Create a new Smart Link for the account. Smart Links are pooled Free Trial or Tracking links that rotate inventory automatically.

post/api/smart-links

Request

  • Base URL
    https://app.onlyfansapi.com
  • URL
    https://app.onlyfansapi.com/api/smart-links
  • Auth
    HTTP bearer

Request body

account_idstring required

The prefixed ID of the OnlyFans or Fanvue account to create the Smart Link for. Fanvue accounts are accepted on teams with Fanvue enabled.

namestring required

The name of the Smart Link

cloaking_enabledboolean

Filter automated visits before opening the destination. Defaults to true.

event_source_urlstring

HTTP(S) page URL reported for this link’s pixel events, overriding the pixel URL. Send null to use the pixel or click URL.

link_type'free_trial' | 'tracking_link'

The type of Smart Link to create. Required for OnlyFans accounts and rejected for Fanvue accounts.

free_trial_daysinteger

The number of free trial days (required if link_type is free_trial). Must be between 1 and 360. Rejected for Fanvue accounts.

Example request

{
  "account_id": "acct_XXXXXXXX",
  "name": "Instagram Bio Link",
  "cloaking_enabled": true,
  "event_source_url": "https://example.com/sofia",
  "link_type": "free_trial",
  "free_trial_days": 7
}

Response

Success

Example response

{
  "data": {
    "id": "01JCZWQJZXQJZXQJZXQJZXQJZX",
    "platform": "onlyfans",
    "creator_id": "123456789",
    "creator_username": "examplecreator",
    "name": "Instagram Bio Link",
    "link_type": "free_trial",
    "traffic_redirect_url": "https://trk.of-traffic.com/go/01JCZWQJZXQJZXQJZXQJZXQJZX",
    "event_source_url": null,
    "free_trial_days": 7,
    "clicks_count": 0,
    "conversions_count": 0,
    "subscribers_count": 0,
    "revenue": "0.00",
    "cost": {
      "inputMode": null,
      "inputValue": null,
      "perSub": null,
      "perClick": null,
      "perPromo": null,
      "subscriberSourceCount": 0,
      "clickSourceCount": 0
    },
    "account": {
      "id": "acct_XXXXXXXX",
      "display_name": "Example Creator",
      "username": "examplecreator"
    },
    "created_at": "2025-01-15T10:30:00+00:00",
    "updated_at": "2025-01-15T10:30:00+00:00"
  },
  "_meta": {
    "_credits": {
      "used": 0,
      "balance": 999999985,
      "note": "Free endpoint"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 10000000,
      "limit_day": 50000,
      "remaining_minute": 9999998,
      "remaining_day": 49988
    }
  }
}

Changes

    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

    • info

      added the new optional request property

    • info

      the request property became optional

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status