v11

latestOpenAPI 3.1.12026-08-03174162.0 MB
Admissions

Create a new admission

post/events/{eventId}/admissions

Path parameters

eventIdstring required

Identifier of the event to which this admission type is linked

Example:evt_01jps5cgsenjrazw6wswmyspa3

Request body

namestring required

The display name of the admission type shown to customers

subtitlestring

Short supporting text shown below the admission name

descriptionstring

Detailed information shown when customers expand 'More info'

capacitynumber

Maximum number of tickets that can be sold for this admission type. A value of -1 indicates unlimited

limitnumber

Maximum number of tickets of this admission type that can be purchased in a single order. A value of -1 indicates unlimited

ordernumber required

Determines the position in which this admission type appears when listed. Lower values appear first

entryStartsAtstring required

Wall clock time from which tickets of this type are valid for entry (no timezone)

entryEndsAtstring required

Wall clock time until which tickets of this type are valid for entry (no timezone)

saleStartsAtstring required

Wall clock time when ticket sales for this admission type begin (no timezone)

saleEndsAtstring required

Wall clock time when ticket sales for this admission type end (no timezone)

saleEndsBehavior'SALE_ENDED' | 'SOLD_OUT' | 'DOOR'

Label to display for this admission after ticket sales have ended

visibility'ALWAYS' | 'HIDDEN' | 'AFTER_ADMISSION'

Controls whether this admission type is shown publicly, revealed by a scoped coupon, or unlocked after another admission.

visibleAfterAdmissionIdstring nullable

Unique admission identifier

sectionIdstring nullable

Unique section identifier

teamIdstring required

Team that owns this admission. Denormalized for efficient queries.

promoterIdstring required

Identifier of the promoter responsible for this admission type

eventSlugstring required

URL-friendly slug for the event associated with this admission type

Example request

{
  "name": "Final Release",
  "subtitle": "Entry before 10pm",
  "description": "Early bird pricing with priority entry. Must present valid ID at gate.",
  "capacity": 100000,
  "limit": -1,
  "entryStartsAt": "2026-08-04T06:13:52",
  "entryEndsAt": "2026-08-05T06:13:52",
  "saleStartsAt": "2026-08-03T06:13:52",
  "saleEndsAt": "2026-08-05T06:13:52",
  "saleEndsBehavior": "SALE_ENDED",
  "price": {
    "base": 1000,
    "booking": 200,
    "currency": "AUD"
  },
  "visibility": "ALWAYS",
  "sectionId": "sct_01jps5cgse0g3qj16kpq8t221r",
  "promoterId": "pmt_01jqpjksnsen9vprw95et60t2m",
  "eventSlug": "test-event"
}

Response

OK

Example response

{
  "admission": {
    "id": "adm_01jps5cgsee0xvapbk92e8eb4g",
    "createdAt": "2026-08-03T06:13:52.214Z",
    "updatedAt": "2026-08-03T06:13:52.214Z",
    "sectionId": "sct_01jps5cgse0g3qj16kpq8t221r",
    "teamId": "tem_01jqpjksnsen9vprw95et60t2m",
    "promoterId": "pmt_01jqpjksnsen9vprw95et60t2m",
    "eventId": "evt_01jps5cgsenjrazw6wswmyspa3",
    "eventSlug": "test-event",
    "name": "Final Release",
    "subtitle": "Entry before 10pm",
    "description": "Early bird pricing with priority entry. Must present valid ID at gate.",
    "capacity": 100000,
    "limit": -1,
    "available": 70000,
    "sold": 20000,
    "reserved": 10000,
    "order": 0,
    "entryStartsAt": "2026-08-04T06:13:52",
    "entryEndsAt": "2026-08-05T06:13:52",
    "saleStartsAt": "2026-08-03T06:13:52",
    "saleEndsAt": "2026-08-05T06:13:52",
    "saleEndsBehavior": "SALE_ENDED",
    "price": {
      "base": 1000,
      "booking": 200,
      "currency": "AUD"
    },
    "visibility": "ALWAYS",
    "tenantId": "tnt_01jqpj2t2kfvmstt6f6tzkbaf2",
    "deleted": false,
    "orderPadded": "0000000000"
  }
}