---
title: "Create Promotion"
method: POST
path: "/api/{account}/promotions"
tags: ["Promotions"]
---

# Create Promotion

`POST /api/{account}/promotions`

Create a new promotion for the account.

## Request body

- object
  - `type` 'new' | 'expired' | 'new_and_expired', required — Whether this promotion should apply to new subscribers, expired subscribers, or both. **IMPORTANT: when set to new_and_expired, the OF will create two separate promotions.**
  - `discount` integer, required — The discount percentage for the promotion's first month. Set to 100 to make this promotion a Free Trial.
  - `offerLimit` integer, required — Limit how many people can claim this offer. Set to 0 for no limits.
  - `expirationDays` integer, required — In how many days this offer will expire. Set to 0 to make this promotion infinite.
  - `freeTrialDays` integer — Required only when discount is 100. Sets the duration (in days) of the free trial. Accepted 1-30
  - `message` string — Optionally, provide a message for this promotion.

## Response `200`

- object
  - `data` object[]
    - `id` integer
    - `message` string
    - `rawMessage` string
    - `hasRelatedPromo` boolean
    - `price` integer
    - `type` string
    - `canClaim` boolean
    - `claimsCount` integer
    - `subscribeCounts` integer
    - `subscribeDays` integer
    - `createdAt` string
    - `finishedAt` string
    - `isFinished` boolean
  - `_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` string, nullable
      - `remaining_minute` integer
      - `remaining_day` string, nullable
      - `notice` string

---

[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/revisions/4a99d36f28a3/schema)