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.


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.


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


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


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

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.