Add an Item

https://api.foursquare.com/v2/lists/LIST_ID/additem
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
Note: This endpoint is now the preferred way to add an item to a user's To-do list (/v2/lists/USER_ID/todos/additem).
HTTP MethodPOST
Requires Acting UserYes (learn more)
Parameters
All parameters are optional, unless otherwise indicated.
LIST_IDHZXXY3Yrequired id for a user-created or followed list as well as one of either USER_ID/tips or USER_ID/todos.
venueIdHZXXY3Yoptional A venue to add to the list.
textThis ramen spot is the jamoptional If the target is a user-created list, this will create a public tip on the venue. If the target is /userid/todos, the text will be a private note that is only visible to the author.
urlhttp://nyt.comoptional If adding a new tip via text, this can associate a url with the tip.
tipIdHZXXY3Yoptional Used to add a tip to a list. Cannot be used in conjunction with the text and url fields.
listIdHZXXY3Yoptional Used in conjuction with itemId, the id for a user created or followed list as well as one of either USER_ID/tips or USER_ID/todos.
itemIdHZXXY3Yoptional Used in conjuction with listId, the id of an item on that list that we wish to copy to this list.
Response fields
list itemThe list item that was just added.