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

# Create a new network

`POST /networks`

Creates a new network record for the tenant identified by the `tenant-id` header. The request body's `data` object is validated against the Network JSON schema; currently the only recognized field is `name` (string), with an optional `contractId` also nested inside `data` — no other properties are accepted, and none are required. Requires the `CREATE_NETWORK` permission. On success, returns the created network with its server-assigned ID.

## Headers

- `tenant-id` string, required

## Request body

- CreateNetworkRequest
  - `data` NetworkSchema — Represents collection of health care providers associated with a plan through a contract.
    - `name` string — The name of the network.
    - `contractId` string — The identifier of the associated contract.

## Response `201`

Network created successfully

- NetworkResponse
  - `data` object
    - `id` string, uuid
    - `name` string
    - `contractId` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `500` — Internal server error

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)