New API Version Available
If you added Foursquare after 11/18/21, you automatically have access to the new version (v3) of the API. Please refer to our Places API documentation to ensure you're viewing the correct information to successfully implement Foursquare technology!
For those who are already using the current (v2) version of the API, you may continue to do so or elect to upgrade now. Please contact Foursquare Developer Support for more information.
Allows Foursquare users to add a new venue. All fields are optional, except for ll, name, and primaryCategoryId.
Before adding a place, please make sure your data is properly formatted to adhere to our style guide here.
We require the primaryCategoryId parameter for new venues in order to assign the venue a category. The resulting venues become more meaningful within Foursquare and are more easily searchable by other users. We recommend that applications show their users our category hierarchy (obtained from venues/categories) and allow them to choose something suitable.
Duplicate Venue Errors
The method may return an HTTP 409 error if the new venue looks like a duplicate of an existing venue. This error response will include two useful values: candidateDuplicateVenues and ignoreDuplicatesKey.
In this situation, you can either:
Use one of the candidateDuplicateVenues included in the response of the 409 error. This will not create a new venue.
Ignore duplicates and force the addition of a new venue by resubmitting the same venue add request with two additional parameters: ignoreDuplicates set to true and ignoreDuplicatesKey set to the value from the earlier error response.
What you do with the duplicates should be up to your users; developers should not always just pass ignoreDuplicates=true or always trust the top duplicate candidate.