Developers Information - API & Web Services
API Method /ticket_new
This method creates new fixed-price or donation ticket types. It returns the ID of the newly created ticket.
Arguments
- authentication
- This method controls access via required user authentication.
- event_id integer
- The event ID. The event must have been previously created using /event_new.
- is_donation integer optional
- 0 for fixed-price tickets, 1 for donations. 0 will be used by default if not provided.
- name string
- The ticket name.
- description string optional
- The ticket description.
- price float
- The ticket price. Enter 0.00 for free tickets. Leave blank for a donation.
- quantity integer
- The number of tickets available. Not required for donations.
- start_sales string optional
- The date and time when ticket sales start, in ISO 8601 format (e.g., "2007-12-31 23:59:59").ISO 8601
- end_sales string optional
- The date and time when ticket sales stop, in ISO 8601 format (e.g., "2007-12-31 23:59:59").ISO 8601
- include_fee integer optional
- 0 to add the Eventbrite service fee on top of ticket price, or 1 to include it in the ticket price. 0 will be used by default if not provided.
- min integer optional
- The minimum number of tickets per order.
- max integer optional
- The maximum number of tickets per order.
Example Request
https://www.eventbrite.com/xml/ticket_new?...&event_id=546213823534
&name=Newticket&price=10.0&quantity=5000
Output Parameters
This method returns XML with the following structure:
- id integer
- The ticket ID.
- status string
- Processing status.
- message string
- Processing message.
Example XML Response
<?xml version="1.0" encoding="utf-8" ?> <process> <id>908163459</id> <message>ticket_new : complete</message> <status>ok</status> </process>
Error Codes
This method may return these errors in an error document:
- Authentication Error
- The specified user was not found or the login credentials didn't match.
- Event error
- The event id is missing.
- Not Found
- No such event [12345678].
- Ticket error
- The total number of tickets exceeds the maximum allowed (50).
- Name error
- The ticket name is missing.
- Date error
- The start sales date is invalid or in the past, expected Format (YYYY-MM-DD HH:MM:SS).
- Date error
- The end sales date is invalid or in the past, expected Format (YYYY-MM-DD HH:MM:SS).
- Date inconsistent
- End sales less than Start Sales.
- Date inconsistent
- Start sales date greater than Event's Ending date.
- Date inconsistent
- End sales date greater than Event's Ending date.
- Quantity error
- Please specify the quantity of tickets available.
- Quantity error
- The quantity is invalid, a numeric field is expected.
- Quantity error
- Quantity provided is greater than event capacity [Nnnn].
- Price error
- The price of the ticket is missing or invalid (non-numeric).
- Order error
- The minimum number of tickets per order is invalid (non-numeric) or inconsistent.
- Order error
- The maximum number of tickets per order is invalid (non-numeric) or inconsistent.
- Donation error
- Donation flag must be 0 or 1.
- Fee error
- Service fee must be 0 or 1.