Skip to main content
POST
ChargePoints / Create

Authorizations

Authorization
string
header
required

OAuth2 Bearer Authorization

Scopes

asset:chargepoints

Headers

Accept-Language
string

BCP 47 language tag for content negotiation (e.g. en, de-DE).

Example:

"en"

Body

application/json

Creates a charging point and assigns it to a station, controller, and location. Required permission: asset:chargepoints:create. Available contexts: API Key, User.

location_uuid
string
required

The UUID of the location this charge point belongs to. Cannot be changed after creation.

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
controller_uuid
string
required

The UUID of the controller managing this chargepoint. Must match the OCPP configuration on the physical device to ensure correct communication. Set at creation and cannot be changed via update.

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
station_uuid
string
required

The UUID of the charging station this charge point is part of. Set at creation and cannot be changed via update.

Pattern: ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
evse_id
string
required

Globally unique EVSE-ID following the format defined by the BDEW and exposed to roaming partners. Each EVSE-ID can only be assigned once.

Maximum string length: 100
Example:

"DE*CHC*E0001*0001"

connector_id
integer<int32>
required

OCPP connector ID identifying the connector in OCPP messages between the controller and the backend.

Required range: x >= 0
Example:

"1"

export
boolean
default:true

Controls whether this charging point is included in interface outputs such as the Whitelabel app and POI data. Set to false to hide it from all public-facing outputs. Defaults to true.

phase
enum<string>

Electrical phase type. Must match the hardware configuration and is used for power calculation, app display, and transmission to roaming partners. Allowed values: ac (alternating current), dc (direct current).

Available options:
ac,
dc
Example:

"ac"

position
string

Free-text physical position on site, e.g. "left wall, slot 3".

Maximum string length: 255
Example:

"left connector"

parking_space_numbers
string

Assigned parking space number(s), comma-separated for multiple values. Sequential numbering is recommended when multiple stations share a location and is required for Hectronic payment terminal integrations.

Maximum string length: 20
reserved_parking
integer<int64>

Number of parking spaces at this charging point that are reserved. A value of 0 means no spaces are reserved.

Required range: x >= 0
access
enum<string>

Who may use the charging point. Public charging points must be reported to national access points as required by AFIR. Allowed values: private, public, parapublic (e.g. retail parking during opening hours), carsharing, employee, homecharger, fleet.

Available options:
private,
public,
parapublic,
carsharing,
employee,
homecharger,
fleet
Example:

"fleet"

user
string

Optional free-text label for the intended user group or operator responsible for this charging point (e.g. for home chargers).

Maximum string length: 100
name
string

Optional display name for identifying the charging point in the backend. Does not need to be unique.

Maximum string length: 100
sms_id
integer<int32>

Optional ID for SMS-based charging session initiation. Required only when the charging point supports SMS as an access method.

reservable
boolean
default:false

Whether the charging point can be reserved in advance via the app. Requires the station to support the OCPP reservation feature. Defaults to false.

remote_stop_capable
boolean
default:false

Whether a charging session can be stopped remotely via the app or direct payment interface. Must be explicitly enabled per charging point. Defaults to false.

in_roaming
boolean
default:false

Whether the charging point is enabled for roaming, making it accessible to drivers using third-party EMP apps via platforms such as Hubject, OCPI, or OCHP. The access type and roaming settings together determine visibility in roaming networks. Defaults to false.

access_types
object[]

The access types that can be used to authorize a charging session at this charge point (rfid, sms, key, free, app, other). SMS is only available with the SMS module.

adhoc_type
enum<string>

How ad-hoc charging is offered. Allowed values: none (not offered), standard (paid), free.

Available options:
free,
none,
standard
adhoc_sticker
boolean
default:false

Whether a physical ad-hoc payment sticker (QR / NFC) has been applied. Mandatory for publicly accessible charging points and must be ordered separately. Defaults to false.

serial_number
integer<int32>

Hardware serial number from the manufacturer.

article_number
integer<int32>

Manufacturer SKU identifying the model.

parking_restrictions
string

Free-text parking restrictions (e.g. customers only, max duration). Transmitted to roaming partners and displayed in the app where supported.

Maximum string length: 100
unlock_capable
boolean
default:false

Whether the connector can be unlocked remotely via the backend, for example when a cable becomes stuck. Defaults to false.

public_comment
string

Public-facing comment displayed in the Whitelabel app and transmitted via web services (POI data). Use it for information relevant to end users, such as access instructions or local restrictions.

Maximum string length: 255

Response

The newly created charging point in full projection.

chargepoint
object
required

The charge point record with its EVSE ID, status, access settings and station assignment.