Create scheduled events
When you want to customize the behavior of a waiting room for a specific period of time — such as changing the queueing method or increasing the total active users — set up a scheduled event.
Any properties set on the event will override the default property on the waiting room for the duration of the event.
Create an event
At the moment, you can only create an event using the API.
name(required): Unique name with alphanumeric characters, hyphens, and underscores.
event_start_time(required): ISO 8601 timestamp that marks the start of the event. At this time, queued users will be processed with the event’s configuration. Must occur at least 1 minute before
event_end_time(required): ISO 8601 timestamp that marks the end of the event.
shuffle_at_event_start: If true and
prequeue_start_timeis not null, users in the prequeue will be shuffled randomly at the
event_start_time. Commonly used to ensure fairness if your event is using a .
prequeue_start_time: ISO 8601 timestamp that marks when to begin queueing all users before the event starts. Must occur at least 5 minutes before
description: A text description providing more detail about the event.
suspended: If true, the event is ignored and traffic is handled based on the waiting room’s normal configuration.
When setting up events, you may want to also adjust the default queueing methods for your waiting room.
Set up a “lottery”
Set up a “lottery” system to reward all users who enter into the queue prior to your event start time.
Users who reach your application during the prequeue period are a place in line when the event starts. If the event uses , users who reach your application after the prequeue period are assigned places after users from the prequeue.
Preview an event configuration
This command shows you the event’s configuration as if it were active, meaning that inherited fields from the waiting room will display their current values.
Edit an event
You can disable an event by setting its
suspended parameter to
Additionally, events will not become active if a waiting room itself is Disabled.
Other API commands