---
title: "Create an event occurrence"
method: POST
path: "/v1/event_series/{event_series_id}/events"
tags: ["Event series"]
---

# Create an event occurrence

`POST /v1/event_series/{event_series_id}/events`

For the given event series ID, create an event

## Path parameters

- `event_series_id` string, required

## Response `201`

Successfully created a new event

- EventOccurrence
  - `object` string
  - `id` string — A unique identifier for the event occurrence
  - `available_status` string, nullable — Optional custom status message when event is set to be available
  - `bundles` Bundle[], nullable — List of associated bundles
    - `object` string
    - `id` string
    - `access_code` string, nullable — Code to access a bundle
    - `booking_fee` integer — Booking fee in cents
    - `description` string — Bundle description
    - `group_id` string, nullable — Bundle group ID
    - `name` string — Bundle name
    - `price` integer — Price in cents
    - `products` object[] — Array of associated products
      - `id` string — A unique product identifier
      - `quantity` integer — Product quantity
    - `status` 'HIDDEN' | 'UNAVAILABLE' | 'ON_SALE' | 'SOLD_OUT' — Bundle status
    - `ticket_types` object[] — Array of associated ticket types
      - `id` string — A unique ticket type identifier
      - `quantity` integer — Ticket type quantity
  - `chk` string — Used for Ticket Tailor checkout chk value
  - `currency` 'gbp' | 'usd' | 'eur' | 'sgd' | 'aud' | 'brl' | 'cad' | 'czk' | 'dkk' | 'hkd' | 'huf' | 'ils' | 'jpy' | 'myr' | 'mxn' | 'nok' | 'nzd' | 'php' | 'pln' | 'rub' | 'sek' | 'chf' | 'twd' | 'thb' | 'try' — Information about the currency the event is configured to use
  - `end` object — The end date and time for the event
    - `date` string — ISO-8601 date for the end of the event
    - `formatted` string — A formatted date string for the end of the event
    - `iso` string — ISO-8601 date and time for the end of the event
    - `time` string — Time of the end of the event
    - `timezone` string — Timezone offset for the end of the event
    - `unix` integer — Unix timestamp for for the end of the event
  - `event_series_id` string — A unique identifier for the associated event series
  - `hidden` string — True, if event is set to hidden
  - `online_link` string, nullable — URL of the online event
  - `override_id` string, nullable — A unique identifier for the associated override
  - `revenue` number — Total revenue of the event
  - `sales_tax_label` string, nullable — The label for the sales tax
  - `sales_tax_percentage` integer, nullable — The percentage of the sales tax
  - `sales_tax_treatment` 'inclusive' | 'exclusive', nullable — The treatment of the sales tax
  - `start` object — The start date and time for the event
    - `date` string — ISO-8601 date for the start of the event
    - `formatted` string — A formatted date string for the start of the event
    - `iso` string — ISO-8601 date and time for the start of the event
    - `time` string — Time of the start of the event
    - `timezone` string — Timezone offset for the start of the event
    - `unix` integer — Unix timestamp for the start of the event
  - `max_tickets_sold_per_occurrence` integer, nullable — Maximum quantity of tickets that can be sold across all ticket types
  - `tickets_available` string, nullable — Are there any ticket types available?
  - `ticket_groups` TicketGroup[], nullable
    - `object` string
    - `id` string — A unique identifier for the ticket group
    - `bundle_ids` string[], nullable — An array of associated bundle ids
    - `max_per_order` integer, nullable — Maximum number of tickets allowed per order
    - `max_quantity` integer, nullable — Maximum quantity of tickets that are allowed to be sold for the tickets in the group
    - `min_per_order` integer, nullable — Minimum number of tickets allowed per order
    - `name` string — Name of the ticket group
    - `sort_order` integer — Sort index of the group in the UI
    - `ticket_ids` string[] — An array of associated ticket type ids
  - `ticket_types` TicketType[], nullable
    - `object` string, required
    - `id` string, required — A unique identifier for the ticket type
    - `access_code` string, nullable, required — Code to access a hidden ticket
    - `booking_fee` integer, required — Optional booking fee which is charged per ticket type to the customer and the funds are paid to you.
    - `description` string, nullable, required
    - `discounts` string[] — An array of associated discounts
    - `group_id` string, nullable, required — ID of the group this ticket type belongs to
    - `has_overrides` 'true' | 'false' — Specifies whether the ticket type has overrides
    - `hide_after` object, nullable — Timestamp in seconds when the ticket type should be hidden until.
      - `date` string — ISO-8601 date for the start of the event
      - `formatted` string — A formatted date string for the start of the event
      - `iso` string — ISO-8601 date and time for the start of the event
      - `time` string — Time for the start of the event
      - `timezone` string — Timezone offset for the start of the event
      - `unix` integer — Unix timestamp for the start of the event
    - `hide_until` object, nullable — Timestamp in seconds when the ticket type should be hidden after.
      - `date` string — ISO-8601 date for the start of the event
      - `formatted` string — A formatted date string for the start of the event
      - `iso` string — ISO-8601 date and time for the start of the event
      - `time` string — Time for the start of the event
      - `timezone` string — Timezone offset for the start of the event
      - `unix` integer — Unix timestamp for the start of the event
    - `hide_when_sold_out` 'true' | 'false' — Specifies whether the ticket is hidden when it has sold out
    - `max_per_order` integer, required — Maximum number of ticket types you can select per order
    - `min_per_order` integer, required — Minimum number of ticket types you can select per order
    - `name` string, required — Name of the ticket type
    - `override_id` string, nullable — The ID of the override associated with the ticket type
    - `price` union, required — Cost of the ticket type
      - integer
      - number
    - `show_quantity_remaining` 'true' | 'false' — Specifies whether to show the number of tickets still available
    - `show_quantity_remaining_less_than` integer, nullable — Only show number of tickets still available when the available quantity is equal to or lower than this threshold
    - `status` 'on_sale' | 'sold_out' | 'unavailable' | 'hidden' | 'admin_only' | 'locked', required — Status of the ticket type
    - `sort_order` integer, required — Sort index of ticket type in the UI
    - `type` 'paid' | 'free', required
    - `quantity` integer, required — Number available for purchase
    - `quantity_held` integer, required — Number held
    - `quantity_in_baskets` integer — Number in baskets
    - `quantity_issued` integer, required — Number issued
    - `quantity_total` integer, required — Total number including issued and still available
  - `total_issued_tickets` integer — Total number of issued tickets
  - `transaction_fee_fixed_amount` integer, nullable — Fixed amount of the transaction fee
  - `transaction_fee_percentage` integer, nullable — Percentage of the transaction fee
  - `unavailable` string — True, if event is set to unavailable
  - `unavailable_status` string, nullable — Optional custom status message when event is set to be unavailable
  - `url` string — Event occurrence URL

## Other responses

- `default` — Error schema

---

[API](https://skmtc.net/tickettailor/apis/ticket-tailor-api.md) · [All operations](https://skmtc.net/tickettailor/apis/ticket-tailor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tickettailor/ticket-tailor-api/revisions/7b222e8ec91c/schema)