Create list

Creates a list. When you create a list, a list ID is generated automatically that can be mapped later to add items to the list, and to update and delete the list. After creating a list, you can add items to the list by using POST/{listId}/items endpoint.

POST /list

Try it

Create list

cURL

curl --request POST \
  --url https://prod01.oms.fabric.inc/api/v2/list/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Wishlist",
  "userId": null,
  "listId": "5349b4ddd2781d08c09890f4",
  "listType": "Wish list",
  "notes": "Add items to your wishlist to purchase later",
  "attributes": {
    "attr1": "value1",
    "attr2": "value2"
  },
  "count": 0,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}
'

200

{
  "name": "Wishlist",
  "userId": null,
  "listId": "5349b4ddd2781d08c09890f4",
  "listType": "Wish list",
  "notes": "Add items to your wishlist to purchase later",
  "attributes": {
    "attr1": "value1",
    "attr2": "value2"
  },
  "count": 0,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

List details

name · string · required

Example:

"Wishlist"

userId · string · required

Example:

null

listId · string

Example:

"5349b4ddd2781d08c09890f4"

listType · string

Example:

"Wish list"

notes · string

Example:

"Add items to your wishlist to purchase later"

attributes · object

Show child attributes

attributes. {key} · object

Example:

{ "attr1": "value1", "attr2": "value2" }

Example:

{ "attr1": "value1", "attr2": "value2" }

count · integer<int32>

Number of items added to the list.

Required range: x >= 0

Example:

0

createdAt · string<date-time>

updatedAt · string<date-time>

Response

200

application/json

List Created

List details

name · string · required

Example:

"Wishlist"

userId · string · required

Example:

null

listId · string

Example:

"5349b4ddd2781d08c09890f4"

listType · string

Example:

"Wish list"

notes · string

Example:

"Add items to your wishlist to purchase later"

attributes · object

Show child attributes

attributes. {key} · object

Example:

{ "attr1": "value1", "attr2": "value2" }

Example:

{ "attr1": "value1", "attr2": "value2" }

count · integer<int32>

Number of items added to the list.

Required range: x >= 0

Example:

0

createdAt · string<date-time>

updatedAt · string<date-time>