---
title: "Create IP List"
method: POST
path: "/api/v2/iplists"
tags: ["IP Lists"]
---

# Create IP List

`POST /api/v2/iplists`

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/iplists`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/iplists/post.ts> (a function with typed inputs; its response is checked against the schema)

Create an IP list.

#### Sample Request
```
curl -X POST https://console.jumpcloud.com/api/v2/iplists \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -d '{
    "name": "Sample IP List",
    "ips": [
      "192.168.10.12",
      "192.168.10.20 - 192.168.10.30",
      "123.225.10.0/32"
    ]
  }'
```

## Headers

- `x-org-id` string

## Request body

- IPListRequest
  - `name` string
  - `description` string
  - `ips` string[]

## Response `201`

Created

- IPList
  - `id` string
  - `name` string
  - `description` string
  - `ips` string[]
  - `managedBy` 'ORGANIZATION' | 'ENTERPRISE': IP list ownership.

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/revisions/f396d9271b46?raw)