Promotions

Finish Promotion

Stops an active promotion immediately. The promotion is marked isFinished: true and stops accepting new claims; subscribers who already redeemed keep their existing discount duration. Requires permission api_promotions_finish.

https://public-api.fansmetric.com
POST/v1/{account_id}/promotions/{promo_id}/finish
Bearer

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.

  • promo_id*integer

    OnlyFans promotion ID — from the [Create Promotion](/api-reference/promotions/create-promotion) response or [List Promotions](/api-reference/reach/list-promotions).

curl --request POST "https://public-api.fansmetric.com/v1/acct_XXXXX/promotions/sample_promo_id/finish" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"success":true
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}