Create a sub-network

POST

https://api.ocpplab.io/emsp/networks

POST

/emsp/networks

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.networks.create({
        idempotencyKey: "5d1f7c2e-8b3a-4e6f-9c0d-1a2b3c4d5e6f",
        name: "Fleet fast chargers",
        parent_network_id: 20,
        cpo_ids: [
            "NL*ABC",
            "BE*XYZ",
        ],
        description: "DC sites only",
        countries: [
            "NLD",
            "BEL",
        ],
        power_types: [
            "DC",
        ],
    });
}
main();

{
  "network_id": 21,
  "name": "Fleet fast chargers",
  "network_type": "TENANT",
  "published": false,
  "publish_state": "UNPUBLISHED",
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "emp_identity_id": 3,
  "cpo_ids": [
    "NL*ABC",
    "BE*XYZ"
  ],
  "protocol": "OCPI",
  "publicly_accessible": false,
  "auto_accept_cpo_additions": false,
  "created_at": "2026-09-30T10:00:00Z",
  "updated_at": "2026-09-30T10:00:00Z",
  "description": "DC sites only",
  "parent_network_id": 20,
  "countries": [
    "NLD",
    "BEL"
  ],
  "power_types": [
    "DC"
  ]
}

A named slice of one of your base networks: some of its CPOs, optionally filtered by country, power, parking and facilities.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

namestringRequired1-255 characters

parent_network_idintegerRequired1-9223372036854776000

cpo_idslist of strings or nullOptional

descriptionstring or nullOptional

countrieslist of strings or nullOptional

power_typeslist of strings or nullOptional

parking_typeslist of strings or nullOptional

facilitieslist of strings or nullOptional

auto_accept_cpo_additionsboolean or nullOptionalDefaults to false

publicly_accessibleboolean or nullOptionalDefaults to false

Response

The created sub-network.

network_idinteger

namestring

network_typeenum or any

publishedboolean

publish_stateenum or any

organization_idstring

emp_identity_idinteger

cpo_idslist of strings

protocolstring

publicly_accessibleboolean

auto_accept_cpo_additionsboolean

created_atdatetime

updated_atdatetime

unpublish_started_atdatetime or nullOptional

unpublish_drain_untildatetime or nullOptional

descriptionstring or nullOptional

parent_network_idinteger or nullOptional

countrieslist of strings or nullOptional

power_typeslist of strings or nullOptional

parking_typeslist of strings or nullOptional

facilitieslist of strings or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error

Authentication

Headers

Request

Response

Errors