Creates a plug
Creates a plug. Required permission: asset:plugs:create. Available contexts: API Key, User
Authorizations
OAuth2 Bearer Authorization
Body
Creates a plug. Required permission: asset:plugs:create. Available contexts: API Key, User
The UUID of the charge point this plug is physically attached to. Set at creation and cannot be changed via update. Each plug must always be linked to exactly one charge point.
^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$Identifier of the plug type. Must reference an existing row in the client's emobility_plug_types table; unknown ids are rejected with a 422 response. The full plug-type record is returned alongside as the embedded "plug_type" object on read endpoints.
x >= 1The electrical phase configuration of this plug. Must match the hardware specification and is used for power calculations and display in the app and roaming outputs.
ac1, ac3, dc "AC3"
The current rating of this plug in amperes. Displayed in the app and transmitted to roaming partners. Typical values: 16A (Schuko), 32A (Type 2), 200A (CHAdeMO), 600A (CCS2).
0 <= x <= 9999The voltage of this plug in volts. Displayed in the app and transmitted to roaming partners. Typical values: 230V (Type 1/Schuko), 400V (Type 2 AC), up to 1000V (DC fast charging).
0 <= x <= 9999The maximum charging power of this plug in kilowatts. One of the most important fields for end users, as drivers filter charge points by this value when searching for a suitable location.
x >= 0Indicates whether this plug is currently active and available for charging sessions. Inactive plugs are not shown in public-facing outputs or transmitted to roaming partners.
Indicates whether this plug can be physically locked to the vehicle during a charging session. When true, the connector supports a locking mechanism that prevents accidental disconnection.
Indicates whether this plug has a permanently attached charging cable. When true, the driver does not need to bring their own cable to use this connector.
The length of the attached cable in centimeters. Only relevant when with_cable is true.
x >= 0Controls whether this plug is included in external API outputs such as the Whitelabel app and POI data. Set to false to hide the plug from all public-facing outputs.
An internal comment about this plug, visible only to backend users. Used for operational notes or installation remarks. Not displayed in the app or transmitted to roaming partners.
255The manufacturer-assigned serial number of the plug hardware.
25The manufacturer's article or part number for this plug.
25Response
Plug created
Plug