Create location | OCPPLab Docs

import requests
url = "https://host.com/ocpp/locations"
payload = {
    "name": "La Defense Charging Hub",
    "address": "14 Rue de la Paix",
    "city": "Paris",
    "country": "FR",
    "coordinates": {
        "latitude": 48.8566,
        "longitude": 2.3522
    },
    "timezone": "Europe/Paris",
    "owner_name": "VINCI Autoroutes",
    "public": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": "4090477f-a416-4515-a302-97aa344a0a2a",
  "slug": "paris-la-defense-hub-a1b2c3d4",
  "name": "La Defense Charging Hub",
  "address": "14 Rue de la Paix",
  "city": "Paris",
  "country": "FR",
  "coordinates": {
    "latitude": 48.8566,
    "longitude": 2.3522
  },
  "timezone": "Europe/Paris",
  "owner_name": "VINCI Autoroutes",
  "public": true,
  "status": "active",
  "created_at": "2026-04-02T09:15:00Z",
  "updated_at": "2026-04-02T09:15:00Z"
}

Create a bare OCPP location row. No OCPI projection is written — use POST /ocpi/cpos/{cpo_id}/locations if the location should be advertised via OCPI.

import requests
url = "https://host.com/ocpp/locations"
payload = {
    "name": "La Defense Charging Hub",
    "address": "14 Rue de la Paix",
    "city": "Paris",
    "country": "FR",
    "coordinates": {
        "latitude": 48.8566,
        "longitude": 2.3522
    },
    "timezone": "Europe/Paris",
    "owner_name": "VINCI Autoroutes",
    "public": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": "4090477f-a416-4515-a302-97aa344a0a2a",
  "slug": "paris-la-defense-hub-a1b2c3d4",
  "name": "La Defense Charging Hub",
  "address": "14 Rue de la Paix",
  "city": "Paris",
  "country": "FR",
  "coordinates": {
    "latitude": 48.8566,
    "longitude": 2.3522
  },
  "timezone": "Europe/Paris",
  "owner_name": "VINCI Autoroutes",
  "public": true,
  "status": "active",
  "created_at": "2026-04-02T09:15:00Z",
  "updated_at": "2026-04-02T09:15:00Z"
}

Create a bare OCPP location row. No OCPI projection is written — use POST /ocpi/cpos/{cpo_id}/locations if the location should be advertised via OCPI.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired

Human-readable location name. The backend derives the slug from this value and appends a random hex suffix for uniqueness.

addressstringRequired

Street address for the site.

citystringRequired

City or locality.

countrystringRequired=2 characters

ISO 3166-1 alpha-2 country code.

coordinatesobjectRequired

Normalized latitude/longitude pair accepted by the location API.

timezonestring or nullOptional

owner_namestring or nullOptional

publicboolean or nullOptional

Response

Location created successfully

idstring

slugstring or null

namestring or null

addressstring or null

citystring or null

countrystring or null

coordinatesobject or map from strings to any or null

timezonestring or null

owner_namestring or null

publicboolean or null

statusstring or null

created_atdatetime or null

updated_atdatetime or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error

1	import requests
2
3	url = "https://host.com/ocpp/locations"
4
5	payload = {
6	"name": "La Defense Charging Hub",
7	"address": "14 Rue de la Paix",
8	"city": "Paris",
9	"country": "FR",
10	"coordinates": {
11	"latitude": 48.8566,
12	"longitude": 2.3522
13	},
14	"timezone": "Europe/Paris",
15	"owner_name": "VINCI Autoroutes",
16	"public": True
17	}
18	headers = {
19	"Authorization": "Bearer <token>",
20	"Content-Type": "application/json"
21	}
22
23	response = requests.post(url, json=payload, headers=headers)
24
25	print(response.json())

1	{
2	"id": "4090477f-a416-4515-a302-97aa344a0a2a",
3	"slug": "paris-la-defense-hub-a1b2c3d4",
4	"name": "La Defense Charging Hub",
5	"address": "14 Rue de la Paix",
6	"city": "Paris",
7	"country": "FR",
8	"coordinates": {
9	"latitude": 48.8566,
10	"longitude": 2.3522
11	},
12	"timezone": "Europe/Paris",
13	"owner_name": "VINCI Autoroutes",
14	"public": true,
15	"status": "active",
16	"created_at": "2026-04-02T09:15:00Z",
17	"updated_at": "2026-04-02T09:15:00Z"
18	}