v1

latestOpenAPI 3.0.32026-08-0623677345.2 KB
Billing

Create plan

post/plans/

Headers

x-simple-workspacestring required

Workspace (account) identifier. Required for every request.

x-piriod-test-modeboolean

Whether to operate against test-mode data. Defaults to false.

Request body

idstring
productstring required

Product ID.

skustring nullable
namestring required
descriptionstring required
frequencystring required

Frequency ID (e.g. monthly).

currencystring required

ISO currency code.

amountnumber required
exemptboolean
usage_scheme'licensed' | 'metered'
usage_aggregation'last_record' | 'max' | 'sum' nullable
tiers_mode'package' | 'volume' | 'graduated' | 'package_overage' | 'unit' | 'range' nullable

Pricing mode for tiered plans. unit and range are deprecated aliases of volume and package respectively.

unit_labelstring nullable
status'active' | 'archived'
archivedstring date-time nullable
createdstring date-time
updatedstring date-time

Response

Plan created.

idstring
productstring required

Product ID.

skustring nullable
namestring required
descriptionstring required
frequencystring required

Frequency ID (e.g. monthly).

currencystring required

ISO currency code.

amountnumber required
exemptboolean
usage_scheme'licensed' | 'metered'
usage_aggregation'last_record' | 'max' | 'sum' nullable
tiers_mode'package' | 'volume' | 'graduated' | 'package_overage' | 'unit' | 'range' nullable

Pricing mode for tiered plans. unit and range are deprecated aliases of volume and package respectively.

unit_labelstring nullable
status'active' | 'archived'
archivedstring date-time nullable
createdstring date-time
updatedstring date-time