Developers Information - API & Web Services
API Method /event_update
This method updates an existing event. Only the fields passed as arguments will be modified. This method returns the ID of the modified event.
Arguments
- authentication
- This method controls access via required user authentication.
- event_id integer
- The ID of the event to update.
- title string
- The event title.
- description string
- 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
- 0 for a private event, 1 for a public event.
- personalized_url string
- The event registration URL.
- venue_idinteger
- The event venue ID. The venue must have been previously created using /venue_new.
- organizer_idinteger
- The event organizer ID. The organizer must have been previously created using /organizer_new.
- capacityinteger
- The maximum number of people who can attend the event.
- currencystring
- The event currency in ISO 4217 format (e.g., "USD", "EUR").
- statusstring optional
- The event status. Allowed values are "draft", "live", "canceled", "deleted".
- custom_headerstring optional
- Custom HTML header for your registration page. Enter a space to reset the custom header.
- custom_footerstring optional
- Custom HTML footer for your registration page. Enter a space to reset the custom footer.
- 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_update?...&id=564512354
&title=New+Title&description=New+Description
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" ?> <event> <id>908163459</id> <status>ok</status> <message>Update event complete</message> </event>
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.
- Not Found
- The specified event id is unknown.
- Title error
- The event name is missing.
- Date error
- The specified start or end date are missing, invalid or in the past.
- Privacy error
- The privacy field must be equal to 0 (public) or 1 (private).
- Organizer error
- The organizer id is missing, invalid (non-numeric) or doesn't belong to the authenticated user.
- Venue error
- The venue id is missing, invalid (non-numeric) or doesn't belong to the authenticated user or event organizer.
- Personalized url error
- The personalized url is already taken by another event.
- 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,live,deleted or canceled.
- Color error
- (Current field) must have a value in a valid hexadecimal format without the pound.