API Method 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:
|
| 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. |