Skip to main content
Distributions define consumer timing and participation inside a sequence. Use these field names with standalone distribution endpoints or nested under POST /experiences sequence creation.

Shared Timing Fields

FieldRequiredDescription
sequenceIdStandalone create onlyParent sequence. Omit this field when creating distributions nested under POST /experiences.
nameYesDistribution name.
openAtNoWhen the distribution becomes active.
closeAtNoWhen the active window ends.
timeZoneNoTime zone for scheduled fields. If omitted during nested experience creation, the organization or experience default is used.
The public timing states are upcoming, active, ended, and killed. Customer-facing docs should use those distribution timing concepts instead of a separate experience-level state machine.

Queues

FieldRequiredDescription
admitRateYesRate at which consumers are admitted.
capacityNoMaximum consumers allowed in the queue.
maxAdmissionsNoMaximum consumers who can be admitted.
admissionExpirationSecondsNoCheckout/access window after admission.

Draws

FieldRequiredDescription
drawAtYesWhen winner selection runs.
winnerCountYesNumber of winners to select.
capacityNoMaximum draw entries.
admissionExpirationSecondsNoCheckout/access window for winners.
continueSelectingUntilCompletedNoContinue selecting replacements until the configured winner count completes, when supported for the launch.

Auctions

FieldRequiredDescription
settleAtYesSettlement deadline/time used in the distribution schedule.
auctionTypeNoenglish or dutch; defaults to english.
reservePriceNoMinimum successful price. Money fields are strings.
minBidIncrementNoMinimum increment for English auctions. Money fields are strings.
autoExtendSecondsNoExtension duration for late bidding.
startPriceNoStarting price for Dutch auctions. Money fields are strings.
floorPriceNoFloor price for Dutch auctions. Money fields are strings.
priceDropAmountNoDutch price drop amount. Money fields are strings.
priceDropIntervalSecondsNoDutch price drop interval.
quantityNoQuantity available for the auction.
Send money values as decimal strings such as "25" or "25.00", never numbers.

Timed Releases

FieldRequiredDescription
supportsGuestYesWhether guest participants can use the timed release.
openAtNoRelease start.
closeAtNoRelease end, if any.

Waitlists

FieldRequiredDescription
sequenceIdYesParent sequence for standalone create.
capacityNoMaximum waitlist entries.
Waitlists capture interest and do not grant checkout access by themselves. They are created and updated through the waitlist surfaces, not through the nested distribution arrays on POST /experiences.

Appointments

FieldRequiredDescription
locationIdNoLocation associated with the appointment distribution.
slotDurationMinutesNoSlot length.
bufferMinutesNoGap between slots.
maxCapacityPerSlotNoMaximum bookings per slot.