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.
event.addTags [HTTP POST]
Add/Replace the user's current tags on an event. This method expects to receive a string with all the tags the user wishes to have on the object. It will replace the current set of user's tags on the event with the new list. This method requires authentication.
Arguments
api_key (Required)
Your API application key. If you don't have one, create one.

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

event_id (Numeric, Required)
The event_id of the event. To get a event_id, try the event.search function.

tags (String, Required)
A space-separated list of tags. Surround multi-word tags with quotes.

Example Response
<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
  <event id="1" name="Tori Amos, Ben Folds" tags="music"
    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" />

</rsp>		
Error Codes
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.
  • Invalid user_id, please contact support.
  • Invalid tags parameter.
  • Could not load event, please make sure you have access to this event id on Upcoming.
  • Unknown error adding tags, please contact support.
Tools
Upcoming Badges for Your Blog/Website | Invite Friends | Groups | Developers API
Help
News Blog | Community Guidelines | FAQ | Contact Us | Suggestion Board | About Us