Box Developer Documentation
Log in
Latest version

Create shield list

post
https://api.box.com/2.0
/shield_lists

Creates a shield list.

Request

bearer [ACCESS_TOKEN]
application/json

Request Headers

stringin headerrequired

Version header

Value is always 2025.0

Request Body

Shield List Content (Country) / Shield List Content (Domain) / Shield List Content (Email) / Shield List Content (IP) objectin body

Specifies the type of elements in this Shield List and includes the elements themselves. It is not possible to update Integration Shield Lists by Public API.

stringin bodyoptional
"A list of things that are shielded"

Description of Shield List: Optional.

stringin bodyrequired
"My Shield List"

The name of the shield list.

Response

application/jsonShield List

Returns the shield list object.

application/jsonClient error

The shield list with this name already exists.

post
Create shield list
You can now try out some of our APIs live, right here in the documentation.
Log in

Response Example

{
  "id": "90fb0e17-c332-40ed-b4f9-fa8908fbbb24",
  "type": "shield_list",
  "content": {
    "type": "country",
    "country_codes": [
      "US",
      "PL"
    ]
  },
  "created_at": "2025-01-13T15:31:01.896Z",
  "description": "A list of things that are shielded",
  "enterprise": {
    "id": "1910967",
    "type": "enterprise"
  },
  "name": "Shield List Name",
  "updated_at": "2025-01-13T15:31:01.896Z"
}