Create a ticket type
POSThttps://api.tickettailor.com/v1/event_series/:event_series_id/ticket_types
For the given event series ID, create a ticket type
Request
Path Parameters
The unique identifier for the event series
- application/x-www-form-urlencoded
Bodyrequired
Code to access a hidden ticket
secret_code_123
Optional booking fee which is charged per ticket type to the customer and the funds are paid to you. We would recommend charging no more than 10% of the ticket price.
155
Description of the ticket type
General admission ticket
List of associated discount IDs
["di_123","di_456"]
Timestamp in seconds when the ticket type should be hidden until.
1744001007
Timestamp in seconds when the ticket type should be hidden after.
1744001007
Hide the ticket when it has sold out
["true","false"]
Maximum number of tickets allowed per order
20
Minimum number of tickets allowed per order
1
Name of the ticket type
General Admission
Cost of the ticket type
600
Number of ticket types available for purchase
55
Specifies whether to show the number of tickets still available
Possible values: [true
, false
]
Only show number of tickets still available when the available quantity is equal to or lower than this threshold
Event series status
Possible values: [ON_SALE
, SOLD_OUT
, UNAVAILABLE
, HIDDEN
, ADMIN_ONLY
, LOCKED
]
ID of the group this ticket type belongs to
gt_54434
Responses
- 201
- default
Successfully created a ticket type
- application/json
- Schema
- Example (auto)
Schema
A unique identifier for the ticket type
Code to access a hidden ticket
Optional booking fee which is charged per ticket type to the customer and the funds are paid to you.
An array of associated discounts
ID of the group this ticket type belongs to
Specifies whether the ticket type has overrides
Possible values: [true
, false
]
hide_after objectnullable
hide_until objectnullable
Specifies whether the ticket is hidden when it has sold out
Possible values: [true
, false
]
Maximum number of ticket types you can select per order
Minimum number of ticket types you can select per order
Name of the ticket type
The ID of the override associated with the ticket type
price objectrequired
Specifies whether to show the number of tickets still available
Possible values: [true
, false
]
Only show number of tickets still available when the available quantity is equal to or lower than this threshold
Status of the ticket type
Possible values: [on_sale
, sold_out
, unavailable
, hidden
, admin_only
, locked
]
Sort index of ticket type in the UI
Possible values: [paid
, free
]
Number available for purchase
Number held
Number in baskets
Number issued
Total number including issued and still available
{
"object": "ticket_type",
"id": "tt_230656",
"access_code": null,
"booking_fee": 0,
"description": null,
"discounts": [
"di_123"
],
"group_id": "tg_21103",
"has_overrides": "true",
"hide_after": 1744001007,
"hide_until": null,
"hide_when_sold_out": "false",
"max_per_order": 100,
"min_per_order": 1,
"name": "4.24 Child (3-12)- Day of event",
"override_id": "ov_11",
"price": 600,
"show_quantity_remaining": "false",
"show_quantity_remaining_less_than": null,
"status": "on_sale",
"sort_order": 50255,
"type": "paid",
"quantity": 10000,
"quantity_held": 10,
"quantity_in_baskets": 0,
"quantity_issued": 700,
"quantity_total": 10710
}
Error schema
- application/json
- Schema
- Example (auto)
Schema
Http status code
Readable error code
Detailed error message
errors object[]
{
"status": 0,
"error_code": "string",
"message": "string",
"errors": [
{
"field": "string",
"messages": [
"string"
]
}
]
}
Authorization: http
name: BasicAuthtype: httpdescription: Use base64 encoded api key created in Ticket Tailor dashboard. scheme: basic
- curl
- php
- ruby
- python
- nodejs
- go
- CURL
curl -L -X POST 'https://api.tickettailor.com/v1/event_series/:event_series_id/ticket_types' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept: application/json' \
-H 'Authorization: Basic PHVzZXJuYW1lPjo8cGFzc3dvcmQ+'