Skip to main content
POST
/
cpl
/
my-offers
/
{id}
Update a published CPL offer.
curl --request POST \
  --url https://studio-api.onlytraffic.com/api/external/v1/cpl/my-offers/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "is_paused": true,
  "per_subscription": 2.65,
  "per_messages": 8,
  "per_first_purchase": 32.5,
  "per_paid_subscription": 51,
  "free_trial_enabled": true,
  "free_trial_days": 2,
  "trial_order_enabled": true,
  "trial_fan_count": 2,
  "max_per_day": 2,
  "total_budget": 1001,
  "content_channels": [],
  "blocked_sources": [],
  "description": "<string>"
}
'
{
  "success": true,
  "data": {
    "offer_id": 123,
    "status": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://onlytraffic.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Patches settings on an offer you own. Any change to a data field sends the offer back to moderation; it goes live again after our team approves it. Pause and unpause via is_paused=true|false. Toggling pause alone does not send the offer back to moderation.

Authorizations

​
X-API-Key
string
header
required

Your API key from the Studio Dashboard

Path Parameters

​
id
integer
required

Numeric resource id.

Required range: x >= 1

Body

application/json

All fields optional; pass only what you want to change. is_paused toggles pause/unpause. Any data field change resets status to moderation.

​
is_paused
boolean

Pause or resume the offer. Set true to pause; set false to resume (the offer re-enters moderation until approved). Toggling pause alone does not trigger a moderation reset on the rest of the offer's data.

​
per_subscription
number<float> | null
Required range: 0.3 <= x <= 5
​
per_messages
number<float> | null
Required range: 1 <= x <= 15
​
per_first_purchase
number<float> | null
Required range: 5 <= x <= 60
​
per_paid_subscription
number<float> | null
Required range: 3 <= x <= 99
​
free_trial_enabled
boolean
​
free_trial_days
integer | null

Required when free_trial_enabled=true. Number of free trial days.

Required range: x >= 1
​
trial_order_enabled
boolean
​
trial_fan_count
integer | null

Required when trial_order_enabled=true. Number of trial fans for first-touch experiments.

Required range: x >= 1
​
max_per_day
integer
Required range: x >= 1
​
total_budget
number<float>
Required range: x >= 1000
​
content_channels
enum<string>[]
Minimum array length: 1
Available options:
lifestyle,
tiktok,
lingerie,
light_nudes,
nudes
​
blocked_sources
enum<string>[]
Available options:
instagram,
tiktok,
twitter,
reddit,
google,
telegram,
tinder,
facebook,
youtube,
onlyfans
​
description
string | null
Maximum string length: 5000

Response

Updated. Any change to a data field sends the offer back to moderation; it goes live again after our team approves it. Pausing or unpausing alone (via is_paused) does not trigger this.

​
success
boolean
​
data
object