Create a plan

POST /api/v1/profiles prm_profiles_create

name and type are the only required fields; everything else has a schema default. A plan created with no enforce toggles on is an unlimited plan.

A quota limit does nothing until its enforce toggle is on. Setting combined_bytes_limit while enforce_combined_bytes is false leaves the plan unlimited on data, and the number sits there looking like a cap. The two always travel together.

At a glance

Authentication: Staff token or session
Requires permission: prm_profiles_create Create profiles
Rate limit: t_mutate

Parameters

Parameter	Description
`name`required body · string	Display name.
`type`required body · enum	prepaid, postpaid, fup, extension or addon.
`base_fee` body · number	Wholesale price to the reseller, major units.
`end_user_price` body · number	Retail price, major units.
`expiration_value` body · integer	Period length, paired with expiration_unit.
`expiration_unit` body · enum	hours, days or months.

Errors

Code	When it is returned
`ERR_VALIDATION`400	name or type missing, or an out-of-range value

Request

curl -X POST "$BASE/api/v1/profiles" \
  -H "Authorization: Bearer $XR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Home 20M",
  "type": "prepaid",
  "base_fee": 150.00,
  "end_user_price": 180.00,
  "enforce_expiration": true,
  "expiration_value": 30,
  "expiration_unit": "days",
  "enforce_combined_bytes": true,
  "combined_bytes_limit": 107374182400,
  "download_kbps": 20480,
  "upload_kbps": 4096
}'

BASE is your tenant host: the same address you sign in on.

Try it on your own network.

50 subscribers for 7 days. You pay nothing.

Try it free Talk to us