Skip to main content
POST
/
cpc
/
orders
Create a CPC order.
curl --request POST \
  --url https://studio-api.onlytraffic.com/api/external/v1/cpc/orders \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "offer_id": 2,
  "creative_public_id": "cpcr_xxxxxxx",
  "clicks": 2,
  "approved_cpc_terms": true,
  "price_per_click": 1
}
'
{
  "success": true,
  "data": {
    "order_id": "cpco_xxxxxxx"
  }
}
price_per_click is optional. Omit it to use the server-derived per-click floor (already adjusted for your tier discount). When provided, it must be greater than or equal to that floor. We recommend running GET /cpc/orders/quote first with the same body to preview cost and eligibility before committing.

Authorizations

​
X-API-Key
string
header
required

Your API key from the Studio Dashboard

Body

application/json
​
offer_id
integer
required
Required range: x >= 1
​
creative_public_id
string
required

Public id of one of your CPC creatives.

Example:

"cpcr_xxxxxxx"

​
clicks
integer
required
Required range: x >= 1
​
approved_cpc_terms
enum<boolean>
required

Must be true. Attests acceptance of the CPC placement terms for this request.

Available options:
true
​
price_per_click
number<float>

Optional. When omitted, uses the server-derived per-click floor (already adjusted for your tier discount). When set, must be >= that floor.

Required range: x >= 0

Response

Created.

​
success
boolean
​
data
object