api_key (Required)
Your API application key. If you don't have one, create one.

token (Required)
An authentication token. (What's this?)

name (Required)
The name of the event.

venue_id (Numeric, Required)
The venue_id of the event. To get a venue_id, try the venue.* series of functions.

category_id (Numeric, Required)
The category_id of the event. To get a category_id, try the category.* series of functions.

start_date (YYYY-MM-DD, Required)
The start date of the event, formatted as YYYY-MM-DD.

end_date (YYYY-MM-DD, Optional)
The end date of the event, formatted as YYYY-MM-DD.

start_time (HH:MM:SS, Optional)
The start time of the event, formatted as HH:MM:SS.

end_time (HH:MM:SS, Optional)
The end time of the event, formatted as HH:MM:SS.

description (Optional)
A textual description of the event.

url (Optional)
The website URL for the event.

personal (1 or 0, Optional, Defaults to 0)
A flag indicating whether the event should be public (0), or shown only to your friends (1).

selfpromotion (1 or 0, Optional, Defaults to 0)
A flag indicating whether the event should be marked as a normal event (0), or as a self-promotional event (1).

ticket_url (Optional)
The website URL for purchasing tickets to the event.

ticket_price (Optional)
The price of a ticket to the event.

ticket_free (1 or 0, Optional, Defaults to 0)
A flag indicating if the event is free (1) or not (0).

<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
  <event id="1" name="Tori Amos, Ben Folds" tags=""
    description="The &quot;Lottapianos&quot; Tour.  Ben Folds is opening, and will 
    play a one hour set." 
    start_date="2003-08-01" 
    end_date="0000-00-00" 
    start_time="19:00:00" end_time="" 
    personal="0" selfpromotion="0" 
    metro_id="1" venue_id="1" 
    user_id="1" category_id="1" 
    date_posted="2003-06-07" 
    ticket_url="http://www.ticketweb.com" ticket_price="$10.00" ticket_free="0" />
</rsp>
		

403 Not Authorized:

• Missing valid authentication parameters - Please pass an authentication token to the method.
• Invalid authentication parameters - either that token was not found, or it may be deactivated. Please contact us for support.

409 Conflict:

• Missing valid api_key - Please create an API key using the above link.
• Your api_key is inactive or not found - Please contact us for support.
• Missing name parameter.
• Missing start_date parameter.
• Invalid metro_id parameter - metro_id must be numeric and refer to a valid metro.
• Invalid user_id parameter - Internal error, please contact us for support.
• Invalid category_id parameter - category_id must be numeric and refer to a valid category.
• Invalid venue_id parameter - venue_id must be numeric and refer to a valid venue.
• Invalid start_date parameter - start_date must be formatted as YYYY-MM-DD.
• Invalid end_date parameter - end_date must be formatted as YYYY-MM-DD.
• Invalid start_time parameter. Valid format is HH:MM:SS.
• Invalid end_time parameter. Valid format is HH:MM:SS.
• End_date cannot be before start_date.
• Ticket_free cannot be set to true if either ticket_url or ticket_price is set.