---
title: "Create an override"
method: POST
path: "/v1/event_series/{event_series_id}/overrides"
tags: ["Overrides"]
---

# Create an override

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

## Request

- Base URL: `https://api.tickettailor.com`
- URL: `https://api.tickettailor.com/v1/event_series/{event_series_id}/overrides`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/tickettailor/apis/ticket-tailor-api/docs/v1/event_series/:event_series_id/overrides/post.ts> (a function with typed inputs; its response is checked against the schema)

For the given event series ID, create an override

## Path parameters

- `event_series_id` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `max_sellable_tickets` integer: Maximum number of sellable tickets
  - `name` string, required: Override name
  - `override_lines` object, required: An array of associated ticket types (prefix id with "tt_"), ticket groups (prefix id with "tg_") or bundles (prefix id with "bu_").
    - `{{id}}` object
      - `price` integer: Price in cents
      - `quantity` integer: Quantity of tickets
      - `status` 'ON_SALE' | 'HIDDEN' | 'SOLD_OUT' | 'UNAVAILABLE' | 'ADMIN_ONLY'

## Response `201`

Successfully created an override

- Override
  - `object` string
  - `id` string
  - `created_at` object: Date and time when the override was created
    - `date` string: ISO-8601 date for the created at date
    - `formatted` string: A formatted date string for the create at date
    - `iso` string: ISO-8601 date and time for the created at date
    - `time` string: Time of the end of the created at date
    - `timezone` string: Timezone offset for the created at date
    - `unix` integer: Unix timestamp for for the created at date
  - `max_sellable_tickets` integer, nullable: Maximum number of sellable tickets
  - `name` string: Override name
  - `override_lines` object[]: Array of ticket types or ticket groups associated with the override
    - `price` integer, nullable: Integer price
    - `quantity` integer, nullable: Quantity of the referenced ticket or ticket group
    - `reference_type` 'ticket' | 'ticket_group': Reference type. This can be either 'ticket' or 'ticket_group'
    - `reference_id` string: ID of the referenced ticket or ticket group. It shold be prefixed with either 'tt_' or 'tg_'
    - `status` 'ON_SALE' | 'SOLD_OUT' | 'UNAVAILABLE' | 'HIDDEN' | 'ADMIN_ONLY' | 'LOCKED', nullable: Status of the referenced ticket or ticket group

## Other responses

- `default`: Error schema

---

[API](https://skmtc.dev/tickettailor/apis/ticket-tailor-api.md) - [All operations](https://skmtc.dev/tickettailor/apis/ticket-tailor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tickettailor/apis/ticket-tailor-api/revisions/b10f60afda54?raw)