Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Sumitbose5/tktplz/llms.txt

Use this file to discover all available pages before exploring further.

Creating an event on TktPlz is a three-step wizard. You start with the event basics, move on to event-specific details and scheduling, and finish with pricing and terms. The form autosaves to browser storage as you work, so you can come back without losing progress.

​
Step 1 — Event basics

The first step collects the three pieces of information that define every event.
1

Enter the event name

Type a clear, descriptive name. This is the name displayed on the event listing and on tickets.
2

Choose the event type

Select one of the available types. Each type has its own data model and booking flow:
TypeWhen to use
SeatingEvents in a hall or cinema where buyers pick specific seats (movies, concerts, conferences)
OpenOutdoor or general-admission events where buyers choose a zone, not a seat (festivals, concerts)
OnlineWebinars, workshops, or live streams delivered over a platform link
RegistrationHackathons, competitions, or any event where participants fill a form to sign up
See Event types for a detailed breakdown of each.
3

Choose a subtype

After selecting the type, choose a subtype that best describes the event:
  • Seating: Movie, Concert, Conference, Other
  • Open: Concert, Other
  • Online: Webinar, Workshop, Live Stream, Other
  • Registration: Hackathon, Concert, Conference, Other

​
Step 2 — Event details

The second step collects scheduling, location, and type-specific information.

​
Fields common to all event types

FieldRequiredNotes
Start date & timeYesThe event start; used to determine booking cutoff windows
End date & timeYesThe event end; used to block check-in after the event closes
DescriptionYesDisplayed on the event listing page
Event instructionsYesShown to ticket holders after purchase
LanguageYes
Rating codeYesU (Universal), UA (Parental Guidance), or A (Adults only)
Eligibility ageYesMinimum age for attendees (enter 0 for no restriction)
Allow ticket cancellationYesWhether ticket holders can cancel and receive a refund
Poster imageYesMust be under 2 MB; uploaded to Cloudinary after the event is created

​
Seating events

For Seating events, you choose a hall and screen rather than entering a free-form venue address.
1

Enter city and state

The form filters available halls to match the city and state you type.
2

Select a hall

Choose from halls registered in TktPlz for your city and state. Each hall has one or more screens.
3

Select a screen

Pick the screen for your event. TktPlz checks availability in real time: if the screen is already booked for an overlapping time window (including a 1-hour buffer after any existing event), you will see an error and must choose a different slot or screen.
TktPlz enforces a 1-hour buffer between seating events on the same screen. If the time slot check fails, the “Next” button stays disabled.

​
Open events

Open events require a physical location address:
  • Location (venue name or address)
  • City
  • State
  • Area name
  • PIN code
  • Max participants (total capacity across all zones)
You can also mark an Open event as online-only, in which case location fields are skipped.

​
Online events

Online events require:
  • Platform: Zoom, Google Meet, or Microsoft Teams
  • Streaming link: The meeting URL — TktPlz validates the format against each platform’s URL pattern
  • Max participants: The capacity cap for the event
  • Registration required: Whether participants must complete a registration step

​
Registration events

Registration events support both online and offline delivery. Offline events require the full location fields (location, city, state, area name, PIN code). Both modes require max participants and an optional eligibility criteria description. If the event is a competition, you can also configure participation type:
  • Individual — solo sign-ups
  • Team — group sign-ups with configurable minimum and maximum team size
You can add custom form fields that participants must fill in. Each field has a name and a type: Text, Number, Date, or Media.

​
Step 3 — Pricing and terms

1

Set ticket pricing

Choose whether the event is paid or free. If paid, select a pricing model:Flat pricing — one price for all tickets
Flat price: ₹500
Total tickets: 200 (derived from capacity)
Categorized pricing — different price tiersFor Seating events, the categories are read from the seat types configured on the selected screen (e.g. Regular, Executive, Premium). For other event types, you define the categories yourself with a name, count, and price.
Regular:    ₹300  ×  100 seats
Executive:  ₹500  ×   50 seats
Premium:    ₹800  ×   20 seats
Total tickets must equal maxParticipantAllowed
2

Configure booking cutoff

Choose when ticket sales close:
Cutoff typeBehavior
until_soldBookings stay open until all tickets are sold
before_startBookings close N minutes before the event starts
custom_timeBookings close at a specific date and time you set
3

Agree to terms and submit

Check the agreement checkbox, then click Submit. TktPlz creates the event record and immediately uploads the poster to Cloudinary, then links the poster URL back to the event.

​
What happens after you submit

After submission, the event is created with verificationStatus: pending and isPublished: true. It is not visible on the public listing until a TktPlz admin sets the status to approved.
Make sure your event name, description, and poster are complete and accurate before submitting. Admins review these details during verification.
The three-stage lifecycle looks like this: 
Created (pending) → Approved (visible to users) → Completed (payouts generated)
Once approved, your event appears in search results and on the event listing pages. Ticket purchases go through Razorpay. When the event end time passes, TktPlz automatically runs a cleanup job and calculates the payout.

Build docs developers (and LLMs) love

Get started for freeTalk to us