Publish a ticket tier (API token, merchant:write). With externalRef the create is idempotent: a repeat returns the existing tier (200, existing: true).

POST /v1/integration/tiers

Error

A valid request URL is required to generate request examples

200

{
  "tier": {
    "id": "<string>",
    "priceMinor": 123,
    "currency": "<string>",
    "eventId": "<string>",
    "title": "<string>",
    "kind": "<string>",
    "availableCount": 123,
    "poolId": "<string>",
    "maxQtyPerPurchase": 123,
    "sellable": true,
    "externalRef": "<string>"
  },
  "existing": true
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

eventId · string · required

title · string · required

priceMinor · integer · required

Integer MINOR units — never a float (invariant #1).

currency · string · required

kind · enum<string> · required

Available options: general, seated

availableCount · integer

maxQtyPerPurchase · integer | null

Required range: x >= 1

sellable · boolean

onSaleStart · string<date-time> | null

onSaleEnd · string<date-time> | null

allowedGeos · string[] | null

allowedSchemes · enum<string>[] | null

Available options: visa, mastercard, amex

poolId · string | null

Draw on a shared inventory pool (general tiers only; then omit availableCount — the pool is the counter). Adult and child prices sharing one room limit, early-bird and standard sharing the floor.

externalRef · string

YOUR stable id for this tier (per tenant, 1–200 chars). Makes creation IDEMPOTENT: a repeat POST with the same externalRef returns the existing tier (200, existing: true) untouched, instead of creating a duplicate. Resend a create whose reply you lost; never create one you cannot recognise.

Required string length: 1 - 200

role · enum<string>

Basket role: primary (standalone admission/table) or addon (parking, shuttle, hospitality).

Available options: primary, addon

category · string | null

Merchant-defined category slug (e.g. parking, vip-table, shuttle). Validated to ^[a-z0-9][a-z0-9_-]{0,39}$.

categoryLabel · string | null

Human-readable label for category.

countsTowardPartySize · boolean | null

Override whether units of this tier count toward the buyer party-size cap (defaults to role !== "addon").

linkRule · object | null

Cross-line basket composition rule enforced server-side at reserve and confirm.

Show child attributes

Response

200

application/json

Default Response

tier · object · required

Show child attributes

existing · boolean