Suggest a New Place

Add a new place that does not currently exist. We will first attempt to find a match in our database. If we do not find a match, we will create a new suggested place.

Query Params
string
required

The proposed value for the name of the new place.

string

Categories to search for. Supports multiple Category IDs, separated by commas.

For a complete list of Foursquare Category IDs, refer to the Category Taxonomy page.

string

The proposed value for the address of the new place.

string

The proposed value for the name of the locality (city) where this new place is.

string

The proposed value for the nearest state or province to the new place.

string

The value for the zip or postal code for the new place.

string

The 2-digit country code where the place is located (e.g. US).

double

The proposed value for the latitude at which the new place should be located (e.g., 41.8781).

double

The proposed value for the longitude at which the new place should be located (e.g., -87.6298).

string

The proposed chain ids to be assosciated with this new place

string

The proposed value if the new place is a subvenue of a larger place (such as a coffee shop within a Target), set this attribute to the ID of the parent place.

boolean

If true, the new place will be marked as private.

string

The proposed new value for the phone number of the place.

string

The proposed value for the url of the homepage of the new place.

string

The proposed value for the email address for this new place

string

The proposed value for the url for this new place's Facebook Page.

string

The proposed value for the instagram handle for this new place

string

The proposed value for the twitter handle of the new place.

string

The proposed value for the hours for the new venue, as a semi-colon separated list of open segments and named segments (e.g., brunch or happy hour). Open segments are formatted as day,start,end. Named segments additionally have a label, formatted as day,start,end,label. Days are formatted as integers with Monday = 1,...,Sunday = 7. Start and End are formatted as [+]HHMM format. Use 24 hour format (no colon), prefix with 0 for HH or MM less than 10. Use '+' prefix, i.e., +0230 to represent 2:30 am past midnight into the following day. To indicate that a venue is open 24/7, send this value with the hours attribute: 1,0000,2400;2,0000,2400;3,0000,2400;4,0000,2400;5,0000,2400;6,0000,2400;7,0000,2400

string

Comma seperated list that represents the attributes that the new place has. Possible values are: {atm, reservation, offers_delivery, parking, outdoor_seating, restroom, credit_cards, wifi}.

boolean
Defaults to true

If true, return the expected result without actually submitting the suggestion. Useful for testing.
Note this defaults to false in all cases EXCEPT when calling through this docs page.

Headers
string
enum
required
Defaults to 2025-06-17

The version of the API to use.

Allowed:
Response

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json