Developers Information - API & Web Services

API Method /event_new

This method creates a new event. It returns the ID of the newly created event.

Arguments

authentication
This method controls access via required user authentication.
title string
The event title.
description string optional
The event description.
start_date string
The event start date and time, in ISO 8601 format (e.g., "2007-12-31 23:59:59").
end_date string
The event end date and time, in ISO 8601 format (e.g., "2007-12-31 23:59:59").
timezone string
The event time zone in relation to GMT (e.g., "GMT+01", "GMT+02", "GMT-01").
privacy integer optional
0 for a private event, 1 for a public event. If not provided, will default to 1.
personalized_url string optional
The event registration URL. If you pass "testevent", the event will be accessible at "http://testevent.eventbrite.com".
venue_idinteger optional
The event venue ID. The venue must have been previously created using /venue_new.
organizer_idinteger optional
The event organizer ID. The organizer must have been previously created using /organizer_new.
capacityinteger optional
The maximum number of people who can attend the event.
currencystring optional
The event currency in ISO 4217 format (e.g., "USD", "EUR").
statusstring optional
The event status. Allowed values are "draft", "live" for new events. If not provided, status will be "draft", meaning that the event registration page will not be available publicly.
custom_headerstring optional
Custom HTML header for your registration page.
custom_footerstring optional
Custom HTML footer for your registration page.
background_colorstring optional
Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
text_colorstring optional
Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
link_colorstring optional
Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
title_text_colorstring optional
Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
box_background_colorstring optional
Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
box_text_colorstring optional
Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
box_border_colorstring optional
Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
box_header_background_colorstring optional
Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
box_header_text_colorstring optional
Custom hexadecimal color for your registration page. Format: FFFFFF without the pound

Example Request

https://www.eventbrite.com/xml/event_new?...&title=NewEvent &description=zzzzz&start_date=2007-12-31 10:00:00 &end_date=2008-01-01 02:00:00&timezone=GMT+01

Output Parameters

This method returns XML with the following structure:

id integer
The event ID.
status string
Processing status.
message string
Processing message.

Example XML Response

<?xml version="1.0" encoding="utf-8" ?>
<process>
	<id>908163459</id>
	<message>event_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.
Title error
The event title is missing.
Date error
The start date is missing.
Date error
The specified start date is invalid or in the past., required format (YYYY-MM-DD HH:MM:SS).
Date error
The end date is missing.
Date error
The specified end date is invalid or in the past., required format (YYYY-MM-DD HH:MM:SS).
Date error
End date less than or equal to start date .
Privacy error
The privacy field must be equal to 0 (public) or 1 (private).
Capacity error
Invalid event capacity (Integer).
Timezone error
Invalid timeZone code (GMT+01,GMT+02 or GMT-01,GMT-02, ..).
Organizer error
The organizer id is invalid or unknown.
Organizer error
The organizer id does not belong to the authenticated user.
Venue error
The venue id is invalid or unknown.
Venue error
The venue id does not belong to the authenticated user or event organizer.
Personalized url error
The personalized event URL you selected is already taken, please select another one.
Currency error
The given currency is invalid or not supported by Eventbrite.
Capacity error
The event capacity is invalid (non-numeric).
Status error
The valid values for event status are : draft or live.
Color error
(Current field) must be formatted as a valid hexadecimal value without the pound. EX: 000000.