Skip to main content
POST
Create a sellable package (bundle) for an offering

Authorizations

x-api-key
string
header
required

API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (*) except POST /v1/projects/{projectId}/events, which needs events:write; a key without * is refused with 403 CAPABILITY_NOT_GRANTED.

Path Parameters

projectId
string
required

The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.

Minimum string length: 1
Example:

"prj_01kv60qgnef2kt3pvqgwmkbzfr"

serviceId
string
required

The service — the sellable thing (a lesson, a treatment). Offerings hang off a service and carry the duration and price.

Minimum string length: 1
Example:

"srv_01kv60qg12e82acr78edfnjhvv"

offeringId
string
required

The offering — one bookable variant of a service, carrying its own duration and regional pricing rules.

Minimum string length: 1
Example:

"off_01kv60qge5eh59ap0gw0pqrrys"

Body

application/json

Package data

pricing
object[]
required
Minimum array length: 1
creditCount
integer
required
Required range: x > 0
name
object
description
object
discountPercent
number

Percentage discount (0-100) recorded when this package's prices were seeded from the offering's prices (price = offering price * creditCount * (1 - discountPercent/100)). Informational metadata only: pricing is the authoritative source of the amounts charged. Individual prices can be manually overridden after seeding, and the offering's prices may change later, so this value is not guaranteed to match the actual prices - never derive amounts from it.

Required range: 0 <= x <= 100
validityDays
integer | null
Required range: x > 0
status
enum<string>
default:ACTIVE

Lifecycle of the package bundle. ARCHIVED hides it from the storefront and blocks new orders, but order items already placed against it stay bookable.

Available options:
DRAFT,
ACTIVE,
ARCHIVED
capacity
integer
default:1
Required range: x > 0

Response

Package created

data
object
required