---
title: "Create a network"
method: POST
path: "/v1/networks"
tags: ["Networks"]
---

# Create a network

`POST /v1/networks`

## Request

- Base URL: `https://api.liara.ir`
- URL: `https://api.liara.ir/v1/networks`
- Auth: HTTP bearer

Creates a private network. Apps and databases in the same network can reach each other privately. The number of networks per account is limited. Your account must be verified.

## Query parameters

- `teamID` string: 24-character hexadecimal ID.

## Request body

- object
  - `networkName` string, required: Lowercase letters, digits and hyphens; can't start or end with a hyphen.

## Response `201`

The network was created.

- object
  - `network` object
    - `_id` string

## Other responses

- `400`: The body or `teamID` is invalid, or you've reached the maximum number of networks.
- `401`: The API token is missing, invalid or expired.
- `403`: Your account isn't verified (`account_verification_required`), or, with `teamID`, you aren't a member of the team (`team_not_found`).
- `409`: You already have a network with this name.

## Changes

- **2026-11-02** `610162e8a623`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/liara-cloud/apis/paas/changes/v1/networks/post.md)

---

[API](https://skmtc.dev/liara-cloud/apis/paas.md) - [All operations](https://skmtc.dev/liara-cloud/apis/paas/llms.txt) - [OpenAPI document](https://skmtc.dev/liara-cloud/apis/paas/revisions/610162e8a623?raw)