API Documentation

Feeling RESTful?

API v2 » event/add (POST w/ OAuth Echo)

Description

This method adds a photo to the specified event owned by the authenticated user. BETA

URL

http://api.twitpic.com/2/event/add.format

Available Formats

xml, json

HTTP Method

POST

Requires Authentication

True

Header Example

	
	OAuth realm="http://api.twitter.com/", 
	oauth_consumer_key="GDdmIQH6jhtmLUypg82g", 
	oauth_signature_method="HMAC-SHA1", 
	oauth_token="819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw", 
	oauth_timestamp="1272325550", 
	oauth_nonce="oElnnMTQIZvqvlfXM56aBLAf5noGD0AQR3Fmi7Q6Y", 
	oauth_version="1.0", 
	oauth_signature="U1obTfE7Rs9J1kafTGwufLJdspo%3D"

X-Auth-Service-Provider (Required)

https://api.twitter.com/1/account/verify_credentials.json

Parameters

  • key (Required): The API key of the calling application/website
  • media_id (Required): The unique ID of the image to add to the event (not the short ID)
  • event_id (Required): The unique ID of the event to add the image to (not the short ID)

Responses

Sample XML Response

	
	<?xml version="1.0" encoding="UTF-8"?>
	<event>
		<id>14</id>
		<short_id>e</short_id>
		<user_id>1</user_id>
		<name>Test Event</name>
		<description>An event.</description>
		<timestamp>2010-07-12 20:51:47</timestamp>
		<images />
	</event>

Example CURL Command

	curl -v -H 'X-Auth-Service-Provider: https://api.twitter.com/1/account/verify_credentials.json' -H 'X-Verify-Credentials-Authorization: OAuth realm="http://api.twitter.com/", oauth_consumer_key="GDdmIQH6jhtmLUypg82g", oauth_signature_method="HMAC-SHA1", oauth_token="819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw", oauth_timestamp="1272325550", oauth_nonce="oElnnMTQIZvqvlfXM56aBLAf5noGD0AQR3Fmi7Q6Y", oauth_version="1.0", oauth_signature="U1obTfE7Rs9J1kafTGwufLJdspo%3D"' -F "key=098f6bcd4621d373cade4e832627b4f6" -F "key=my_app_key" -F "media_id=1234" -F "event_id=4321" http://api.twitpic.com/2/event/add.json