Skip to main content
POST
Creates a chargepoint

Authorizations

Authorization
string
header
required

OAuth2 Bearer Authorization

Body

application/json

Creates a chargepoint. Required permission: asset:chargepoints:create

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

The globally unique EVSE-ID of this charge point, following the format defined by the BDEW. Each EVSE-ID can only be assigned once.

Maximum string length: 100
Example:

"DE*CHC*E0001*0001"

connector_id
integer<int32>
required

The OCPP connector ID of this charge point, used to identify the connector in OCPP messages between the controller and the backend.

Required range: x >= 0
Example:

"1"

export
boolean
default:true

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

phase
enum<string>

The electrical phase type of this charge point, either AC or DC. Must match the hardware configuration and is used for power calculation, display in the app, and transmission to roaming partners.

Available options:
ac,
dc
Example:

"AC"

position
string

A free-text description of the physical position of the charge point within the station or location (e.g. "left connector", "bay 3").

Maximum string length: 255
Example:

"left connector"

parking_space_numbers
string

The parking space number(s) associated with this charge point. Sequential numbering is recommended when multiple stations share a location, and is required for Hectronic payment terminal integrations.

Maximum string length: 20
reserved_parking
string

The number of parking spaces at this charge point that are reserved. A value of 0 indicates that no spaces are reserved.

Maximum string length: 11
access
enum<string>

Defines whether the charge point is publicly accessible or restricted. Public charge points must be reported to national access points as required by AFIR.

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

"fleet"

user
string

An optional free-text field to specify the intended user group or operator responsible for this charge point.

Maximum string length: 100
name
string

An optional name for the charge point, used for identification in the backend. Does not need to be unique.

Maximum string length: 100
sms_id
integer<int32>

An optional ID used for SMS-based charging session initiation. Required only when the charge point supports SMS as an access method.

reservable
boolean
default:false

Indicates whether this charge point can be reserved in advance by users via the app. Requires the station to support the OCPP reservation feature.

remote_stop_capable
boolean
default:false

Indicates whether a charging session at this charge point can be stopped remotely via the app or direct payment interface. Defaults to false and must be explicitly enabled per charge point.

in_roaming
boolean
default:false

Indicates whether this charge point is enabled for roaming, making it accessible to drivers using third-party EMP apps via platforms such as Hubject. The access type and roaming settings together determine visibility in roaming networks.

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.

chargepoint_type
enum<string>

The integration type of this charge point, indicating whether it is managed internally or connected via a roaming protocol (internal, hubject, ochp, ocpi).

Available options:
internal,
hubject,
ochp,
ocpi
adhoc_type
enum<string>

Specifies the direct payment method supported by this charge point for ad-hoc charging without a contract (e.g. credit card terminal, QR code).

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

Indicates whether a direct payment sticker has been physically applied to this charge point. Stickers are mandatory for publicly accessible charge points and must be ordered separately.

serial_number
integer<int32>

The manufacturer-assigned serial number of the charge point hardware.

article_number
integer<int32>

The manufacturer's article or part number for this charge point.

parking_restrictions
string

Describes any restrictions that apply to the parking space at this charge point. Transmitted to roaming partners and displayed in the app where supported.

Maximum string length: 100
unlock_capable
boolean
default:false

Indicates whether the connector at this charge point can be remotely unlocked via the ChargeCloud backend. When true, operators can trigger a remote unlock in case a cable becomes stuck.

public_comment
string

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

Maximum string length: 255

Response

ChargePoint created

chargepoint
object
required

ChargePoint