Create a location

POST

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

POST

/cpo/locations

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.locations.create({
        location_id: "LOC-AMS-01",
        address: "Stationsplein 1",
        city: "Amsterdam",
        country: "NLD",
        coordinates: {
            latitude: "52.37310",
            longitude: "4.88970",
        },
        time_zone: "Europe/Amsterdam",
        name: "Amsterdam depot",
        postal_code: "1012AB",
        parking_type: "PARKING_LOT",
        facilities: [
            "TRAIN_STATION",
        ],
        publish: true,
    });
}
main();

{
  "id": 12,
  "location_id": "LOC-AMS-01",
  "publish": true,
  "address": "Stationsplein 1",
  "city": "Amsterdam",
  "country": "NLD",
  "coordinates": {
    "latitude": "52.37310",
    "longitude": "4.88970"
  },
  "time_zone": "Europe/Amsterdam",
  "last_updated": "2026-09-30T10:00:00Z",
  "revision": 1,
  "role": "CPO",
  "origin": "LOCAL",
  "country_code": "NL",
  "party_id": "OCP",
  "ocpi_version": "2.2.1",
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2026-09-01T09:00:00Z",
  "updated_at": "2026-09-30T10:00:00Z",
  "name": "Amsterdam depot",
  "postal_code": "1012AB",
  "parking_type": "PARKING_LOT",
  "facilities": [
    "TRAIN_STATION"
  ]
}

Creates a location under your OCPI party. A location id is never reused, even after the location is deleted.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

location_idstringRequired1-36 characters

addressstringRequired1-45 characters

citystringRequired1-45 characters

countrystringRequiredformat: "^[A-Z]{3}$"=3 characters

coordinatesobjectRequired

time_zonestringRequired1-255 characters

namestring or nullOptional<=255 characters

postal_codestring or nullOptional<=10 characters

statestring or nullOptional<=20 characters

parking_typeenum or nullOptional

Allowed parking_type values on ocpp.ocpp_locations.

facilitieslist of strings or nullOptional

opening_timesobject or nullOptional

charging_when_closedboolean or nullOptional

publishboolean or nullOptionalDefaults to false

publish_allowed_tolist of objects or nullOptional

related_locationslist of objects or nullOptional

parking_placeslist of objects or nullOptional

directionslist of objects or nullOptional

operatorobject or nullOptional

suboperatorobject or nullOptional

ownerobject or nullOptional

imageslist of objects or nullOptional

energy_mixobject or nullOptional

help_phonestring or nullOptional<=25 characters

Response

The created object.

idinteger

location_idstring

publishboolean

addressstring

citystring

countrystring

coordinatesobject

time_zonestring

last_updateddatetime

revisioninteger

roleenum or any

originenum or any

country_codestring

party_idstring

ocpi_versionenum or any

organization_idstring

created_atdatetime

updated_atdatetime

publish_allowed_tolist of objects or nullOptional

namestring or nullOptional

postal_codestring or nullOptional

statestring or nullOptional

related_locationslist of objects or nullOptional

parking_typeenum or any or nullOptional

parking_placeslist of objects or nullOptional

directionslist of objects or nullOptional

operatorobject or nullOptional

suboperatorobject or nullOptional

ownerobject or nullOptional

facilitieslist of strings or nullOptional

opening_timesobject or nullOptional

charging_when_closedboolean or nullOptional

imageslist of objects or nullOptional

energy_mixobject or nullOptional

help_phonestring or nullOptional

ocpp_versionstring or nullOptional

Errors

401

Unauthorized Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error