Description

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, or 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 parameters to connect the photo back to the corresponding content inside your app.


Request

POST https://api.foursquare.com/v2/photos/add


Authentication

User authentication.


Parameters

Name Example Description
checkinId IHR8THISVNU the ID of a checkin owned by the user.
tipId IHR8THISVNU the ID of a tip owned by the user.
venueId IHR8THISVNU the 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.
pageId 2345 the 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).
broadcast twitter Whether 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.
public 1 When the checkinId is also provided (meaning this is a photo attached to a check-in), 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.
ll 33.7,44.2 Latitude and longitude of the user’s location.
llAcc 1 Accuracy of the user’s latitude and longitude, in meters.
alt 0 Altitude of the user’s location, in meters.
altAcc 1 Vertical accuracy of the user’s location, in meters.
postUrl http://your.site.com/path A 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 nativer link handler is registered and present. We support the following URL schemes: http, https, foursquare, mailto, tel, and sms.
postContentId 3ER4GN93AFWE Identifier for the photo post to be used in a native link handler, up to 50 characters. A checkinId and postUrl must also be specified in the request.
postText Awesome! Text for the photo post, up to 200 characters. A checkinId must also be specified in the request.