Create an EVSE

POST

https://api.ocpplab.io/cpo/evses

POST

/cpo/evses

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.evses.create({
        charge_point_id: "CP-AMS-001",
        evse_type_id: 1,
        evse_uid: "NL*OCP*E1001*1",
        evse_id: "NL*OCP*E1001*1",
        location_id: "LOC-AMS-01",
        capabilities: [
            "RFID_READER",
            "REMOTE_START_STOP_CAPABLE",
        ],
    });
}
main();

{
  "id": 101,
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "charge_point_id": "CP-AMS-001",
  "removed": false,
  "origin": "LOCAL",
  "last_updated": "2026-09-30T10:00:00Z",
  "revision": 1,
  "created_at": "2026-09-01T09:00:00Z",
  "updated_at": "2026-09-30T10:00:00Z",
  "evse_type_id": 1,
  "evse_id": "NL*OCP*E1001*1",
  "evse_uid": "NL*OCP*E1001*1",
  "location_id": "LOC-AMS-01",
  "location_db_id": 12,
  "status": "AVAILABLE",
  "capabilities": [
    "RFID_READER",
    "REMOTE_START_STOP_CAPABLE"
  ],
  "role": "CPO",
  "country_code": "NL",
  "party_id": "OCP",
  "ocpi_version": "2.2.1",
  "ocpp_version": "ocpp2.0.1"
}

Adds an EVSE to one of your chargers. Set location_id and evse_uid so its connectors can be priced and roaming commands reach it.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

charge_point_idstringRequired1-36 characters

evse_type_idintegerRequired>=0

evse_uidstring or nullOptional1-36 characters

evse_idstring or nullOptional<=48 characters

physical_referencestring or nullOptional<=16 characters

location_idstring or nullOptional1-36 characters

capabilitieslist of strings or nullOptional

floor_levelstring or nullOptional<=4 characters

coordinatesobject or nullOptional

directionslist of objects or nullOptional

parking_restrictionslist of strings or nullOptional

accepted_service_providerslist of strings or nullOptional

imageslist of objects or nullOptional

Response

The created object.

idinteger

organization_idstring

charge_point_idstring

removedboolean

originenum or any

last_updateddatetime

revisioninteger

created_atdatetime

updated_atdatetime

evse_type_idinteger or nullOptional

evse_idstring or nullOptional

evse_uidstring or nullOptional

physical_referencestring or nullOptional

location_idstring or nullOptional

location_db_idinteger or nullOptional

statusenum or any or nullOptional

status_schedulelist of objects or nullOptional

capabilitieslist of strings or nullOptional

floor_levelstring or nullOptional

coordinatesobject or nullOptional

directionslist of objects or nullOptional

parking_restrictionslist of strings or nullOptional

parkinglist of objects or nullOptional

accepted_service_providerslist of strings or nullOptional

imageslist of objects or nullOptional

rolestring or nullOptional

country_codestring or nullOptional

party_idstring or nullOptional

ocpi_versionstring or nullOptional

ocpp_versionstring or nullOptional

responded_atdatetime or nullOptional

Errors

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