Register a charger point

POST

https://api.ocpplab.io/proxy/charger-points

POST

/proxy/charger-points

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.proxy.chargerPoints.create({
        charge_point_id: "CP-AMS-001",
        label: "Amsterdam depot, bay 1",
        vendor: "ABB",
        model: "Terra AC W22",
        ocpp_version: "ocpp2.0.1",
        security_profile: 1,
        metadata: {
            site: "ams-depot",
        },
        basic_auth_password: "s3cure-charger-password",
    });
}
main();

{
  "id": "5f0c1a2b-3c4d-4e5f-8a9b-0c1d2e3f4a5b",
  "charge_point_id": "CP-AMS-001",
  "created_at": "2026-09-30T10:00:00Z",
  "updated_at": "2026-09-30T10:00:00Z",
  "label": "Amsterdam depot, bay 1",
  "vendor": "ABB",
  "model": "Terra AC W22",
  "serial_number": "ABB-22-000123",
  "firmware_version": "1.8.2",
  "ocpp_version": "ocpp2.0.1",
  "enabled": true,
  "security_profile": 1,
  "metadata": {
    "site": "ams-depot"
  },
  "has_basic_auth": true,
  "last_seen_at": "2026-09-30T10:00:00Z"
}

Registers a charger on the OCPP gateway for the organization in the Bearer JWT. An optional basic_auth_password sets the charger’s HTTP Basic credentials; it is never returned (see has_basic_auth). 409 if the charge_point_id is already registered.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

charge_point_idstringRequired1-255 characters

Id the charger uses in its WebSocket path.

labelstring or nullOptional

vendorstring or nullOptional

modelstring or nullOptional

serial_numberstring or nullOptional

firmware_versionstring or nullOptional

ocpp_versionenum or nullOptional

Allowed values:

enabledbooleanOptionalDefaults to true

security_profileintegerOptional0-3Defaults to 0

metadatamap from strings to anyOptional

basic_auth_passwordstring or nullOptional16-40 characters

Write-only; responses expose only has_basic_auth.

Response

Successful Response

idstringformat: "uuid"

charge_point_idstring

created_atdatetime

updated_atdatetime

labelstring or nullOptional

vendorstring or nullOptional

modelstring or nullOptional

serial_numberstring or nullOptional

firmware_versionstring or nullOptional

ocpp_versionenum or nullOptional

Allowed values:

enabledbooleanOptionalDefaults to true

security_profileintegerOptionalDefaults to 0

metadatamap from strings to anyOptional

has_basic_authbooleanOptionalDefaults to false

last_seen_atdatetime or nullOptional

revisionintegerOptionalDefaults to 1

Bumped on every update.

Errors

401

Unauthorized Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error