v11

latestOpenAPI 3.1.12026-08-03174162.0 MB

Sections

Create a new section

post/events/{eventId}/sections

Path parameters

eventIdstring required

Unique identifier of the event this section belongs to

Example:evt_01jps5cgsenjrazw6wswmyspa3

Request body

namestring required

Display name of the section (e.g., 'VIP Area', 'General Admission')

capacitynumber

Maximum number of attendees for this section. Use -1 for unlimited capacity

limitnumber

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

teamIdstring required

Team that owns this section. Denormalized for efficient queries.

ordernumber

Display order of the section. Lower numbers appear first in listings. Defaults to 0 if not specified

visibility'ALWAYS' | 'STACKED' | 'HIDDEN'

Controls how this section is shown: always list all visible admissions, stack to show the cheapest available admission, or hide until a scoped coupon reveals it.

locationIdstring

ID of an existing location. Either locationId or googlePlaceId must be provided.

googlePlaceIdstring

Google Place ID to create a new location from. Either locationId or googlePlaceId must be provided.

Example request

{
  "name": "General Admission",
  "capacity": 1000,
  "limit": -1,
  "visibility": "ALWAYS",
  "locationId": "loc_01jqpjksnsen9vprw95et60t2m",
  "googlePlaceId": "ChIJN1t_tDeuEmsRUsoyG83frY4"
}

Response

Example response

{
  "section": {
    "id": "sct_01jps5cgse0g3qj16kpq8t221r",
    "createdAt": "2026-08-03T06:13:52.214Z",
    "updatedAt": "2026-08-03T06:13:52.214Z",
    "name": "General Admission",
    "capacity": 1000,
    "limit": -1,
    "available": 700,
    "sold": 200,
    "reserved": 100,
    "visibility": "ALWAYS",
    "location": {
      "id": "loc_01hk153x00eh99pagyydz03sbz",
      "googlePlaceId": "ChIJP3Sa8ziYEmsRUKgyFmh9AQM",
      "createdAt": "2026-08-03T06:13:52.214Z",
      "updatedAt": "2026-08-03T06:13:52.214Z",
      "name": "Watson's EQ",
      "address": "The, Entertainment Quarter, 1 Bent St, Moore Park NSW 2021, Australia",
      "city": "Moore Park",
      "state": "New South Wales",
      "postcode": "2021",
      "country": "Australia",
      "latitude": -33.8944593,
      "longitude": 151.2252255,
      "timeZone": "Australia/Sydney",
      "types": [
        "establishment",
        "point_of_interest",
        "stadium"
      ],
      "description": "Historic outdoor amphitheater known for summer concerts",
      "image": {
        "src": "https://assets.session.services/my-image.jpg",
        "alt": "My Image",
        "width": 1080,
        "height": 1080
      }
    },
    "promoterId": "pmt_01jqpjksnsen9vprw95et60t2m",
    "eventId": "evt_01jps5cgsenjrazw6wswmyspa3",
    "eventSlug": "test-event"
  }
}