Welcome, Guest Sign In | Sign Up | Help
Upcoming API Documentation
Currently, the use of these APIs are restricted to non-commercial use only. If you'd like to use it for commercial purposes, please contact us first.
venue.add [HTTP POST]
Add a new venue to the database. You must pass authentication parameters for this function.
Arguments
api_key (Required)
Your API application key. If you don't have one, create one.

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

venuename (Required)
The name of the venue.

venueaddress (Required)
The name of the venue.

venuecity (Required)
The name of the venue.

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

venuezip (Optional)
The venue's Zip Code or equivalent.

venuephone (Optional)
The venue's phone number.

venueurl (Optional)
The url of the venue's website (if any).

venuedescription (Optional)
A textual description of the venue.

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

Example Response (returns the details for the venue you added)
<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
	<venue id="6087" name="Test REST Venue.add" address="123 Privacy Ln" 
		city="Los Angeles" zip="" phone="" url="" description="" 
		user_id="10708" private="0" />
</rsp>		
Error Codes (sent in HTTP Response Header)
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 venuename parameter.
  • Missing venueaddress parameter.
  • Missing venuecity 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.
Tools
Upcoming Badges for Your Blog/Website | Invite Friends | Groups | Developers API
Help
News Blog | Community Guidelines | FAQ | Contact Us | Suggestion Board