Create a connector

POST

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

POST

/cpo/connectors

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.connectors.create({
        evse_db_id: 101,
        connector_id: 1,
        evse_type_connector_id: 1,
        ocpi_connector_id: "1",
        standard: "IEC_62196_T2",
        format: "SOCKET",
        power_type: "AC_3_PHASE",
        max_voltage: 400,
        max_amperage: 32,
        max_electric_power: 22000,
    });
}
main();

{
  "id": 201,
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "charge_point_id": "CP-AMS-001",
  "evse_id": 101,
  "connector_id": 1,
  "evse_type_connector_id": 1,
  "status": "Available",
  "error_code": "NoError",
  "auto_created": false,
  "timestamp": "2026-09-30T10:00:00Z",
  "last_updated": "2026-09-30T10:00:00Z",
  "revision": 1,
  "evse_uid": "NL*OCP*E1001*1",
  "ocpi_connector_id": "1",
  "ocpi_status": "AVAILABLE",
  "standard": "IEC_62196_T2",
  "format": "SOCKET",
  "power_type": "AC_3_PHASE",
  "max_voltage": 400,
  "max_amperage": 32,
  "max_electric_power": 22000,
  "tariff_ids": [
    "TARIFF-AC-STD"
  ],
  "ocpp_version": "ocpp2.0.1"
}

Adds a connector to one of your EVSEs; the charger, OCPI EVSE uid and OCPP version are copied from the EVSE. 409 if the EVSE is partner data.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

evse_db_idintegerRequired>=1

connector_idintegerRequired>=0

evse_type_connector_idintegerRequired>=1

ocpi_connector_idstring or nullOptional1-36 characters

standardstring or nullOptional<=36 characters

formatenum or nullOptional

OCPI connector format.

Allowed values:

power_typeenum or nullOptional

OCPI power type.

Allowed values:

max_voltageinteger or nullOptional>=0

max_amperageinteger or nullOptional>=0

max_electric_powerinteger or nullOptional>=0

typestring or nullOptional<=50 characters

terms_and_conditionsstring or nullOptional<=255 characters

terms_and_conditions_urlstring or nullOptional<=1024 characters

capabilitieslist of strings or nullOptional

Response

The created object.

idinteger

organization_idstring

charge_point_idstring

evse_idinteger

connector_idinteger

evse_type_connector_idinteger

statusstring

error_codestring

auto_createdboolean

timestampdatetime

last_updateddatetime

revisioninteger

evse_uidstring or nullOptional

ocpi_connector_idstring or nullOptional

ocpi_statusenum or any or nullOptional

typestring or nullOptional

standardstring or nullOptional

formatenum or any or nullOptional

power_typeenum or any or nullOptional

max_voltageinteger or nullOptional

max_amperageinteger or nullOptional

max_electric_powerinteger or nullOptional

infostring or nullOptional

vendor_idstring or nullOptional

vendor_error_codestring or nullOptional

fault_code_decodedstring or nullOptional

fault_sourcestring or nullOptional

terms_and_conditionsstring or nullOptional

terms_and_conditions_urlstring or nullOptional

tariff_idslist of strings or nullOptional

capabilitieslist of strings 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