---
title: "Create a network"
method: POST
path: "/networks/create"
tags: ["Network"]
---

# Create a network

`POST /networks/create`

## Request body

- NetworkCreateConfig — is the expected body of the "create network" http request message
  - `Name` string — Name is the name of the network.
  - `CheckDuplicate` boolean — CheckDuplicate is used to check the network is duplicate or not.
  - `Driver` string — Driver means the network's driver.
  - `EnableIPv6` boolean
  - `IPAM` IPAM — represents IP Address Management
    - `Driver` string
    - `Options` object
    - `Config` IPAMConfig[]
      - `Subnet` string — subnet address for network
      - `IPRange` string — sub ip range in sub-network
      - `Gateway` string — gateway for sub-network
      - `AuxAddress` object — aux address in sub-network
  - `Internal` boolean — Internal checks the network is internal network or not.
  - `Options` object
  - `Labels` object

## Response `201`

The network was created successfully

- NetworkCreateResp — contains the response for the remote API: POST /networks/create
  - `Id` string — ID is the id of the network.
  - `Warning` string — Warning means the message of create network result.

## Other responses

- `400` — bad parameter
- `409` — name already in use
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.net/aliyun/apis/pouch-engine-api.md) · [All operations](https://skmtc.net/aliyun/apis/pouch-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aliyun/pouch-engine-api/versions/36d75b2825fc/schema)