API Method event_new
This method creates a new event, returning the ID of the newly created resource. 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 in relation to GMT (e.g., “GMT+01″, “GMT+02″, “GMT-01″). |
| 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”). |
| 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. |
| 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. |
| 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. |