Description

Allows you to add an item to a list.

All fields are optional, but exactly one of the following must be specified:

  • venueId
  • tipId
  • listId and itemId

Request

POST https://api.foursquare.com/v2/lists/LIST_ID/additem


Authentication

User authentication.


Parameters

Name Example Description
LIST_ID IHR8THISVNU required id for a user-created or followed list as well as USER_ID/tips
venueId IHR8THISVNU A venue to add to the list.
url http://foursquare.com If adding a new tip via text, this can associate a url with the tip.
tipId IHR8THISVNU Used to add a tip to a list. Cannot be used in conjunction with the text and url fields.
listId IHR8THISVNU Used in conjuction with itemId, the id for a user created or followed list as well as USER_ID/tips
itemId IHR8THISVNU Used in conjuction with listId, the id of an item on that list that we wish to copy to this list.