API Documentation

• API Methods
• Authentication
• API Errors

API Method /venue_new

This method creates a new venue. It returns the ID of the newly created venue.

Arguments

authentication

This method controls access via required user authentication.

organizer_id integer

The ID of the related organizer.

venue string

The venue name.

adressstring optional

The venue adress (line 1).

adress_2string optional

The venue adress (line 2).

citystring optional

The venue city.

region string

The venue state/province/county/territory depending on the country. 2-letter state code is required for US addresses.

postal_codestring optional

The postal code of the venue.

country_codestring

2-letter country code, according to the ISO 3166 format.

Example Request

Output Parameters

This method returns XML with the following structure:

id integer

The venue ID.

status string

Processing status.

message string

Processing message.

Example XML Response

<?xml version="1.0" encoding="utf-8" ?>
<process>
	<id>908163459</id>
	<message>Add venue complete</message>
	<status>ok</status>
</process>

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.

Organizer error

The specified organizer id is missing, invalid (non-numeric) or doesn't belong to the current user.

Venue error

The venue name is missing.

The specified venue name already exists for the current user and specified organizer id.

Country error

The country code is missing or invalid.

Region/State error

The state code is missing or invalid (2 digits for US address).