Zero TrustZero Trust Lists

Create Zero Trust list

POST
Creates a new Zero Trust list.

Path parameters

identifierstringRequired

Request

This endpoint expects an object.
name
stringRequired
The name of the list.
type
enumRequired
The type of list.
Allowed values: SERIALURLDOMAINEMAILIP
description
stringOptional
The description of the list.
items
list of objectsOptional
The items in the list.

Response

This endpoint returns an object
result
objectOptional
POST
1curl -X POST https://api.cloudflare.com/client/v4/accounts/699d98642c564d2e855e9661899b7252/gateway/lists \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "name": "Admin Serial Numbers",
6 "type": "SERIAL",
7 "description": "The serial numbers for administrators",
8 "items": [
9 {
10 "created_at": "2014-01-01T05:20:00.12345Z",
11 "value": "8GE8721REF"
12 }
13 ]
14}'
200Successful
1{
2 "result": {
3 "created_at": "2014-01-01T05:20:00.12345Z",
4 "description": "The serial numbers for administrators",
5 "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
6 "items": [
7 {
8 "created_at": "2014-01-01T05:20:00.12345Z",
9 "value": "8GE8721REF"
10 }
11 ],
12 "name": "Admin Serial Numbers",
13 "type": "SERIAL",
14 "updated_at": "2014-01-01T05:20:00.12345Z"
15 }
16}