No results

Create a list

Create a new, empty list.

POST https://api.jsonpad.io/lists

Example

cURL
12345678910111213141516171819202122curl https://api.jsonpad.io/lists \
  -H "Content-Type: application/json" \
  -H "x-api-token: <YOUR TOKEN>" \
  -d '{
        "name": "My New List",
        "description": "This is a new list",
        "pathName": "my-new-list",
        "schema": {
          "type": "object",
          "properties": {
            "name": { "type": "string" },
            "age": { "type": "number" }
          },
          "required": ["name"]
        },
        "pinned": false,
        "readonly": false,
        "realtime": true,
        "protected": false,
        "indexable": true,
        "activated": true
      }'

Parameters

No parameters

Request headers

  • required
    x-api-tokenstringYour API token.

Request body

{
name: "Sample List"
pathName: "sample-list"
description: "Sample list description"
schema: null
pinned: false
readonly: false
realtime: false
protected: false
indexable: true
activated: true
}
  • optional
    namestringThe name of the list.
  • optional
    pathNamestring

    The path name of new list. This can be used instead of the id in URLs.

    This must be unique. You cannot have two lists with the same path name.

  • optional
    descriptionstringA description of the list.
  • optional
    schemanullable object

    The schema of the list. When items are created or modified in this list, we will check their data against this schema.

    This uses the JSON Schema format. It will be null if the list has no schema.

  • optional
    pinnedbooleanWhether the list is pinned to the dashboard menu for quick access.
  • optional
    readonlybooleanWhether the list is read-only. This affects the list and all items contained within it.
  • optional
    realtimebooleanWhether realtime updates are enabled for this list. If this is enabled, the list will emit events when it is modified or deleted, and when items are created, updated or deleted within it.
  • optional
    protectedbooleanWhether the list is protected. Protected lists cannot be deleted if they contain any items.
  • optional
    indexablebooleanWhether the list is indexable. We cannot view a list of items in a non-indexable list. Also, non-indexable lists cannot be searched.
  • optional
    activatedbooleanWhether the list is activated. Inactive lists are not accessible via the API.

Response body

201 Created
{
id: "a8f472d0-b752-4426-acb4-ab71d3e1df37"
createdAt: "2026-09-05T11:29:39.578Z"
updatedAt: "2026-09-05T11:29:39.578Z"
user: {
id: "2cc52927-8755-406a-9b4b-f82a2f1971cd"
createdAt: "2026-09-05T11:29:39.578Z"
updatedAt: "2026-09-05T11:29:39.578Z"
lastActiveAt: "2026-09-05T11:29:39.578Z"
activated: true
displayName: "Sample User"
description: "Sample user description"
}
name: "Sample List"
pathName: "sample-list"
description: "Sample list description"
schema: null
pinned: false
readonly: false
realtime: false
protected: false
indexable: true
activated: true
itemCount: 0
}

Response headers

  • locationhttps://api.jsonpad.io/lists/6267e0f9-dfd6-4b38-8999-74de6d1d093aThe URL of the newly created list.
  • last-modified2026-09-05T11:29:39.578ZThe date this list was last modified.
2024-10-29