Add a Photo

https://api.foursquare.com/v2/photos/add
Allows users to add a new photo to a checkin, tip, venue, or page update in general.

All fields are optional, but exactly one of the id fields (checkinId, tipId, venueId, pageId) must be passed in.

In addition, the image file data must be posted. The photo should be uploaded as a jpeg and the Content-Type should be set to "image/jpeg". Images may not exceed 5MB in size.

Attaching a photo to a tip or a venue makes it visible to anybody. By default, attaching a photo to a checkin makes it visible only to the people who can see the checkin (the user's friends, unless the checkin has been sent to Twitter or Facebook); this can be overridden by specifying public=1 in the request. Attaching a photo to a page is visible to anybody and is intended for use only in an update.

Multiple photos can be attached to a checkin, venue, or page, but there can only be one photo per tip.

To avoid double-tweeting, if you are sending a checkin that will be immediately followed by a photo, do not set broadcast=twitter on the checkin, and just set it on the photo.

When adding a photo to a checkin, specify the post* params to connect the photo back to the corresponding content inside your app. For more information, see our documentation on native links.
HTTP MethodPOST
Requires Acting UserYes (learn more)
Parameters
All parameters are optional, unless otherwise indicated.
checkinIdIHR8THISVNUthe ID of a checkin owned by the user.
tipIdIHR8THISVNUthe ID of a tip owned by the user.
venueIdIHR8THISVNUthe ID of a venue, provided only when adding a public photo of the venue in general, rather than a photo for a private checkin, tip, or page update.
pageId2345the ID of a page, provided only when adding a photo that will be in an update for that page (no other ids should be specified).
broadcasttwitterWhether to broadcast this photo. Send twitter if you want to send to twitter, facebook if you want to send to facebook, or twitter,facebook if you want to send to both.
public1When the checkinId is also provided (meaning this is a photo attached to a checkin), this parameter allows for making the photo public and viewable at the venue. Valid values are 1 and 0 (default).
Note that photos attached to venues, tips, and pages (updates) are always public.
ll33.7,44.2Latitude and longitude of the user's location.
llAcc1Accuracy of the user's latitude and longitude, in meters.
alt0Altitude of the user's location, in meters.
altAcc1Vertical accuracy of the user's location, in meters.
postUrlhttp://your.site.com/pathA link for more details about the photo. This page will be opened in an embedded web view in the foursquare application, unless contentId is specified and a native link handler is registered and present. We support the following URL schemes: http, https, foursquare, mailto, tel, and sms.
postContentId3ER4GN93AFWEIdentifier for the photo post to be used in a native link, up to 50 characters. A checkinId and postUrl must also be specified in the request.
postTextAwesome!Text for the photo post, up to 200 characters. A checkinId must also be specified in the request.
Response fields
photoThe photo that was just created.