> ## Documentation Index > Fetch the complete documentation index at: https://chargecloud.dev/llms.txt > Use this file to discover all available pages before exploring further. # Plugs / Create > Creates a plug and attaches it to a chargepoint of the authenticated client. Required permission: asset:plugs:create. Available contexts: API Key, User. ## OpenAPI ````yaml /api/core-api/crmiapi.json post /api/v1/assets/plugs openapi: 3.2.0 info: title: chargecloud - Core API summary: chargecloud Core API. All around CRM, Asset Management and more. version: 1.141.0 description: chargecloud Core API. All around CRM, Asset Management and more. servers: - url: https://api.chargecloud.dev description: Production - chargecloud Core API - url: https://demo.chargecloud.de description: Sandbox/Dev - chargecloud Core API security: [] paths: /api/v1/assets/plugs: post: tags: - Plugs summary: Plugs / Create description: >- Creates a plug and attaches it to a chargepoint of the authenticated client. Required permission: asset:plugs:create. Available contexts: API Key, User. operationId: /api/v1/assets/plugs_POST parameters: - name: Accept-Language in: header description: BCP 47 language tag for content negotiation (e.g. en, de-DE). required: false schema: type: string description: BCP 47 language tag for content negotiation (e.g. en, de-DE). example: en requestBody: description: >- Creates a plug and attaches it to a chargepoint of the authenticated client. Required permission: asset:plugs:create. Available contexts: API Key, User. content: application/json: schema: type: object required: - chargepoint_uuid - type_id - phase - ampere - voltage - max_power - active - fixable - with_cable - cable_length - export properties: chargepoint_uuid: type: string pattern: >- ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$ description: >- 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. type_id: type: integer format: int32 minimum: 1 description: >- Identifier of the plug type (e.g. Type 2, CCS, CHAdeMO). Allowed values come from PlugTypes / List; unknown ids are rejected with a 422 response. An incorrect plug type may cause the connector to fail quality checks and be excluded from public outputs and roaming platforms. phase: type: string enum: - ac1 - ac3 - dc description: >- Electrical phase wiring. Allowed values: ac1 (single-phase AC), ac3 (three-phase AC), dc (direct current / fast charging). example: ac3 ampere: type: integer format: int32 minimum: 0 maximum: 9999 description: >- Maximum supported current in amperes. Displayed in the app and transmitted to roaming partners. Typical values: 16A (Schuko), 32A (Type 2), 200A (CHAdeMO), 600A (CCS2). voltage: type: integer format: int32 minimum: 0 maximum: 9999 description: >- Nominal voltage 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). max_power: type: number format: float minimum: 0 description: >- The 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. active: type: boolean default: true description: >- Whether the plug is in service. Inactive plugs are excluded from public visibility and roaming. fixable: type: boolean default: true description: >- Whether the plug can be mechanically locked during a session. with_cable: type: boolean default: false description: >- True for tethered plugs with a fixed cable, false for sockets. cable_length: type: integer format: int32 minimum: 0 description: >- Cable length in centimeters. Only meaningful when with_cable is true. comment: type: string maxLength: 255 description: Free-form internal note, visible only to back-office users. export: type: boolean default: false description: >- Whether the plug is advertised through outbound roaming and public APIs (OICP, OCPI). serial_number: type: string maxLength: 25 description: Hardware serial number of the plug. article_number: type: string maxLength: 25 description: Manufacturer article (model) number. required: true responses: '201': headers: Content-Language: description: The locale of the response content (BCP 47 language tag). required: false schema: type: string example: en content: application/json: schema: type: object required: - plug properties: plug: type: object properties: uuid: type: string pattern: >- ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$ description: >- The unique identifier of the plug, automatically assigned by the system upon creation. Use this UUID to retrieve or reference the plug in subsequent API calls. created_at: type: string format: date pattern: ^\d{4}-\d{2}-\d{2}$ description: Creation timestamp of the plug record. updated_at: type: string format: date pattern: ^\d{4}-\d{2}-\d{2}$ description: Last-write timestamp of the plug record. plug_type: type: object properties: id: type: integer format: int32 description: >- Internal numeric identifier of the plug type. Same value as plug.type_id. name: type: string maxLength: 50 description: >- Human-readable name of the plug type (e.g., "Type 2", "CCS Combo 2"). standard: type: string maxLength: 64 description: >- Standard identifier used by roaming protocols (OCHP / OCPI), e.g. "IEC_62196_T2", "Chademo", "MCS". required: - id - name description: PlugTypeReference chargepoint_uuid: type: string pattern: >- ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$ description: >- 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. type_id: type: integer format: int32 minimum: 1 description: >- Identifier of the plug type (e.g. Type 2, CCS, CHAdeMO). Allowed values come from PlugTypes / List; unknown ids are rejected with a 422 response. An incorrect plug type may cause the connector to fail quality checks and be excluded from public outputs and roaming platforms. phase: type: string enum: - ac1 - ac3 - dc description: >- Electrical phase wiring. Allowed values: ac1 (single-phase AC), ac3 (three-phase AC), dc (direct current / fast charging). example: ac3 ampere: type: integer format: int32 minimum: 0 maximum: 9999 description: >- Maximum supported current in amperes. Displayed in the app and transmitted to roaming partners. Typical values: 16A (Schuko), 32A (Type 2), 200A (CHAdeMO), 600A (CCS2). voltage: type: integer format: int32 minimum: 0 maximum: 9999 description: >- Nominal voltage 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). max_power: type: number format: float minimum: 0 description: >- The 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. active: type: boolean default: true description: >- Whether the plug is in service. Inactive plugs are excluded from public visibility and roaming. fixable: type: boolean default: true description: >- Whether the plug can be mechanically locked during a session. with_cable: type: boolean default: false description: >- True for tethered plugs with a fixed cable, false for sockets. cable_length: type: integer format: int32 minimum: 0 description: >- Cable length in centimeters. Only meaningful when with_cable is true. comment: type: string maxLength: 255 description: >- Free-form internal note, visible only to back-office users. export: type: boolean default: false description: >- Whether the plug is advertised through outbound roaming and public APIs (OICP, OCPI). serial_number: type: string maxLength: 25 description: Hardware serial number of the plug. article_number: type: string maxLength: 25 description: Manufacturer article (model) number. required: - uuid - created_at - updated_at - plug_type - chargepoint_uuid - type_id - phase - ampere - voltage - max_power - active - fixable - with_cable - cable_length - export description: >- The plug record of a charge point with its plug type and electrical ratings. description: The newly created plug. '401': headers: Content-Language: description: The locale of the response content (BCP 47 language tag). required: false schema: type: string example: en content: application/json: schema: type: object required: - error properties: error: type: string description: Error message description: Unauthorized '403': headers: Content-Language: description: The locale of the response content (BCP 47 language tag). required: false schema: type: string example: en content: application/json: schema: type: object required: - error properties: error: type: string description: Error message description: Forbidden '405': headers: Content-Language: description: The locale of the response content (BCP 47 language tag). required: false schema: type: string example: en content: application/json: schema: type: object required: - error properties: error: type: string description: Error message description: Method not allowed '422': headers: Content-Language: description: The locale of the response content (BCP 47 language tag). required: false schema: type: string example: en content: application/json: schema: type: object required: - errors properties: errors: type: array items: type: object properties: errorKey: type: string description: A key identifying the error message: type: string description: The error message parameter: type: string description: The parameter that caused the error, if any required: - errorKey - message - parameter description: Error description: List of errors description: Request validation failed '500': headers: Content-Language: description: The locale of the response content (BCP 47 language tag). required: false schema: type: string example: en content: application/json: schema: type: object required: - error properties: error: type: string description: Error message description: Internal server error security: - bearer: - asset:plugs components: securitySchemes: bearer: type: http description: OAuth2 Bearer Authorization scheme: bearer bearerFormat: JWT ```` ## Related topics - [Stations / Create](https://chargecloud.dev/api-reference/stations/stations-create.md) - [Plugs / Read](https://chargecloud.dev/api-reference/plugs/plugs-read.md) - [Plugs / List](https://chargecloud.dev/api-reference/plugs/plugs-list.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.