POST /api/lists

Requires: OAuth 2.0

Create a new list for a user. This writes user data that can be fetched with /api/lists.

Example

Here's an example of creating a list. This call requires a valid access_token to authorize the call for the user. You can see how to get one here.

POSThttps://api.boardgameatlas.com/api/lists?client_id=

headers: {
      Authorization: Bearer 57074b78b1282526107158f16sl3b253faf4dc05
}
body: {
      "name": "Best Games of 2018"
}

Response

 {
   "list": {
      "id": "9Cfe6jmIu3",
      "name": "Best Games of 2018",
      "username": "trentellingsen"
   }
}

Parameters

These are all the posible parameters to add to the POST body.

ParameterTypeExampleDetails
nameStringOwned(Required) The name of the game list you're creating. There are two special lists you can create called Owned and Wishlist which have extra behavior on the website with specific data on the user profile pages.