Create Event Occurrence
POST
/events/{eventId}/occurrencesAdd a new date and time for an event.
Events don't happen on their own-they need occurrences. An occurrence is a
specific date and time when the event takes place, with its own capacity and
ticket availability.
You can create multiple occurrences for the same event (matinee and evening
shows, a week-long run, etc.).
When to use this
- Adding show dates when setting up a new event
- Creating recurring performances (daily, weekly, etc.)
- Adding extra dates when an event sells well
Parameters
eventIdpathrequiredEvent ID
Request Body
startDate*string (date-time)Start date (ISO date)
startTime*stringStart time (HH:mm:ss)
endDate*string (date-time)End date (ISO date)
endTime*stringEnd time (HH:mm:ss)
timezonestringOccurrence timezone (can override event timezone)
venueIdstringVenue ID (can override event venue)
venueLayoutIdstringVenue layout ID
ticketSchemeIdstringTicket scheme to use for this occurrence
priceSchemeIdstringPrice scheme to use (must belong to the ticket scheme)
ticketCategoryId*stringTicket category ID from the ticket scheme
venueLayoutCategoryId*stringVenue layout category ID to map to
enabledbooleanWhether this category is enabled for this occurrence
status*"draft" | "on_sale" | "sold_out" | "completed" | "cancelled"Occurrence status
Response
Event occurrence created successfully
Notes
ℹ️The occurrence inherits settings from its parent event, but you can override capacity and other details.
💡Make sure to set the correct timezone-dates are stored in UTC but displayed in the event's local timezone.
Code Samples
Create Event Occurrence using the TypeScript SDK:
import { BackstageClient } from '@ticketlayer/backstage';
const client = new BackstageClient({
organisationSlug: 'your-org',
});
client.setAccessToken('YOUR_ACCESS_TOKEN');
// Create eventoccurrence
const eventoccurrence = await client.eventoccurrence.create({
name: 'New EventOccurrence',
// Add other required fields
});
console.log(`Created eventoccurrence with ID: ${eventoccurrence.id}`);