Back to Events

event_new

This method creates a new event page and returns the associated event_id.

Authentication tokens are required.

Request Parameters

Name description
title The event title. 255 characters max.
description The event description.
start_date The event start date and time, in ISO 8601 format (e.g., “2007-12-31 23:59:59″).
end_date The event end date and time, in ISO 8601 format (e.g., “2007-12-31 23:59:59″).
timezone The event time zone using the full Olson timezone name (e.g., “Europe/London,” “America/Los_Angeles,” “US/Pacific”)
privacy 0 for a private event, 1 for a public event. If not provided, will default to 0.
personalized_url The event registration URL. If you pass “testevent”, the event will be accessible at “http://testevent.eventbrite.com”.  This string is limited to 255 characters max.
venue_id The event venue ID. The venue must have been previously created using /venue_new.
organizer_id The event organizer ID. The organizer must have been previously created using /organizer_new.
capacity The maximum number of people who can attend the event.
currency The event currency in ISO 4217 format (e.g., “USD”, “EUR”).
locale To set or update the event page language, set the locale parameter to a valid Eventbrite supported locale. Currently supported locales are:

en_US,en_CA,fr_CA,en_GB,en_IE,de_DE,es_ES,fr_FR, it_IT,nl_NL,pt_PT,sv,en_AU,en_NZ,en_SG,en_HK,en_IN

status 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_header Custom HTML header for your registration page.
custom_footer Custom HTML footer for your registration page.
confirmation_page Custom text, or HTML+CSS for your event’s order confirmation page. Setting this value to a single URL allows you to redirect attendees to a third-party page upon order completion.
confirmation_email Custom text to include in your order confirmation email.
background_color Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
text_color Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
link_color Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
title_text_color Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
box_background_color Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
box_text_color Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
box_border_color Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
box_header_background_color Custom hexadecimal color for your registration page. Format: FFFFFF without the pound
box_header_text_color Custom hexadecimal color for your registration page. Format: FFFFFF without the pound

Example Request URL

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

Example Response

<?xml version="1.0" encoding="utf-8" ?>
<process>
	<id>908163459</id>
	<message>event_new : complete</message>
	<status>ok</status>
</process>

Method-Specific Errors

More information about error-handling and common error messages are available in our error docs.

error_type error_message
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.
Organizer error The specified Venues ID does not match the Organizer ID.
Venue error The venue id does not belong to the authenticated user.
Venue error The venue id is invalid or unknown.
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.
Locale error The locale is invalid or unsupported. Please make sure you are using the proper locale format (i.e. en_US, fr_FR)
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.