---
title: "Create Free Trial Link"
method: POST
path: "/api/{account}/trial-links"
tags: ["Free Trial Links"]
---

# Create Free Trial Link

`POST /api/{account}/trial-links`

Create a new free trial link for the account

## Request body

- object
  - `tags` string[] — Array of tag names to add to the trial link.
  - `name` string, nullable — The name of the trail link (optional). Cannot be longer than 64 characters.
  - `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**.
  - `offerLimit` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 50 | 100, required — How many people can use this offer. Must either be **0** (for no limit), or a number between **1**-**10**, **50**, or **100**.
  - `duration` 1 | 3 | 7 | 14 | 30 | 90 | 180 | 360, 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).

## Response `200`

Success

- object
  - `data` object
    - `id` integer
    - `trialLinkName` string
    - `url` string
    - `subscribeDays` integer
    - `subscribeCounts` integer
    - `claimCounts` integer
    - `expiredAt` string
    - `createdAt` string
    - `isFinished` boolean
  - `_pagination` object
    - `next_page` string, nullable
  - `_meta` object
    - `_credits` object
      - `used` integer
      - `balance` integer
      - `note` string
    - `_cache` object
      - `is_cached` boolean
      - `note` string
    - `_rate_limits` object
      - `limit_minute` integer
      - `limit_day` integer
      - `remaining_minute` integer
      - `remaining_day` integer

---

[API](https://skmtc.net/onlyfansapi/apis/onlyfans-api.md) · [All operations](https://skmtc.net/onlyfansapi/apis/onlyfans-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onlyfansapi/onlyfans-api/versions/4a99d36f28a3/schema)