Create Zero Trust List

POST

https://api.cloudflare.com/client/v4/accounts/{identifier}/gateway/lists

Last modified:2022-12-16 13:48:36

Create a new Zero Trust List.

Request

Path Params

identifier

string

required

Body Params application/json

description

string

optional

The description of the List.

Example:

The serial numbers for administrators

items

array [object {1}]

optional

The items in the List.

value

string

optional

The value of the item in a List.

Example:

8GE8721REF

name

string

required

The name of the List.

Example:

Admin Serial Numbers

type

enum<string>

required

The type of List.

Allowed values:

SERIALURLDOMAINEMAILIP

Example:

SERIAL

Example

{
    "description": "The serial numbers for administrators",
    "items": [
        {
            "value": "8GE8721REF"
        }
    ],
    "name": "Admin Serial Numbers",
    "type": "SERIAL"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts//gateway/lists' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "The serial numbers for administrators",
    "items": [
        {
            "value": "8GE8721REF"
        }
    ],
    "name": "Admin Serial Numbers",
    "type": "SERIAL"
}'

Responses

🟢200Create Zero Trust List response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object

optional

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "created_at": "2014-01-01T05:20:00.12345Z",
        "description": "The serial numbers for administrators",
        "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
        "items": [
            {
                "created_at": "2014-01-01T05:20:00.12345Z",
                "value": "8GE8721REF"
            }
        ],
        "name": "Admin Serial Numbers",
        "type": "SERIAL",
        "updated_at": "2014-01-01T05:20:00.12345Z"
    },
    "success": true
}

🟢200Create Zero Trust List response failure

Modified at 2022-12-16 13:48:36

List Zero Trust Lists

Delete Zero Trust List