API Method /venues/new

Creates a new venue with the provided information. See http://eventful.com/venues/new for an example interface.


This method requires user authentication.
name string
The displayed name for this venue.
address string
The street address of the venue. (optional)
city string
The city name. (optional)
region string
The name of the region (state, province, county) (optional)
postal_code string
The postal code or ZIP code. (optional)
country string
The name of the country.
description string
The venue description. (optional)
privacy integer
The privacy setting for this venue. (1 = public, 2 = private, 3 = semi-private) (optional, defaults to 1)
venue_type string
The type of venue (e.g. Cinema, Arena). See the new venue page for a current list of options.
url string
A URI link to further information about this venue. (optional)
url_type string
The type of the link provided in the url parameter (e.g. Blog, Review, Official Site). See the "Add a link" section of any event page for a current list. (optional)
parent_id string
The ID of this venue's parent venue. (optional)

Example Request

Here's an example request URL:

http://api.eventful.com/rest/venues/new?...&name=Prince+Charles+Cinema& address=7+Leicester+Place&city=London&region=London,+City+of &postal_code=WC2H+7BP&country=United+Kingdom&venue_type=Cinema

Output Parameters

Output from this function is an XML block with the following constructs:
status atrtribute string
message string
"Add venue complete"
id string
The ID of the newly-created venue.

Example XML Response

<?xml version="1.0" encoding="UTF-8"?>

<response status="ok">
  <message>Add venue complete</message>

Error Codes

This method may return these errors in an error document:

Authentication error
The specified user was not found or provided invalid credentials.
Invalid Parent
The specified parent venue_id was not found.