Skip to content
CreatoRainCreatoRain API

Set your surcharge per video, once for all stores

PUT
/settings
curl --request PUT \
  --url https://data.creatorain.com/partner/v1/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "surcharge_per_video": 10 }'

A JSON number from 0 to 10000, in whole cents (10 or 10.5, not "10"). It replaces the default surcharge. It applies to new quotes and to stores confirmed after it. Stores already confirmed keep the price they were confirmed with until their plan changes. PARTNER KEY ONLY.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
surcharge_per_video
required
number
<= 10000

Example 

10

Responses

Section titled “Responses”

200

Section titled “200”

The stored settings.

Media typeapplication/json
object
surcharge_per_video
required
number
currency
required
string
updated_at
required
string
nullable

Example 

{
  "surcharge_per_video": 10,
  "currency": "USD",
  "updated_at": "2026-10-01T09:00:00Z"
}

400

Section titled “400”

validation_error. field names the offending parameter.

Media typeapplication/json
object
error
required
object
code
required

The stable value to branch on.

string
Allowed values: unauthorized forbidden_ip rate_limited validation_error location_already_exists location_not_found location_terminated reservation_not_found conflict internal_error
message
required

A human sentence. Copy, not contract; it may be reworded.

string
field

The request field at fault, dotted for a nested one (plan.term_months).

string

Example 

{
  "error": {
    "code": "unauthorized"
  }
}

401

Section titled “401”

unauthorized. A missing, malformed, unknown or revoked key; or an invalid, expired or wrong-store dashboard token. One answer for every case on purpose: the holder of a bad credential learns nothing from the difference.

Media typeapplication/json
object
error
required
object
code
required

The stable value to branch on.

string
Allowed values: unauthorized forbidden_ip rate_limited validation_error location_already_exists location_not_found location_terminated reservation_not_found conflict internal_error
message
required

A human sentence. Copy, not contract; it may be reworded.

string
field

The request field at fault, dotted for a nested one (plan.term_months).

string

Example 

{
  "error": {
    "code": "unauthorized"
  }
}

429

Section titled “429”

rate_limited. Over this key’s requests-per-minute ceiling.

Media typeapplication/json
object
error
required
object
code
required

The stable value to branch on.

string
Allowed values: unauthorized forbidden_ip rate_limited validation_error location_already_exists location_not_found location_terminated reservation_not_found conflict internal_error
message
required

A human sentence. Copy, not contract; it may be reworded.

string
field

The request field at fault, dotted for a nested one (plan.term_months).

string

Example 

{
  "error": {
    "code": "unauthorized"
  }
}