Skip to main content
POST
/
v3
/
chargers
Create Charger
curl --request POST \
  --url https://app.plugchoice.com/api/v3/chargers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identity": "<string>",
  "team_uuid": "<string>",
  "site_uuid": "<string>"
}
'
{
  "uuid": "<string>",
  "id": 123,
  "identity": "<string>",
  "reference": "<string>",
  "connection_status": "<string>",
  "status": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "licenses": {
    "smart": true,
    "pro": true
  },
  "permissions": {
    "basic": true,
    "sensitive": true,
    "full": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://developer.plugchoice.com/llms.txt

Use this file to discover all available pages before exploring further.

Registers a new charger. The charger is assigned to the authenticated user’s team. If the user does not have a team, a personal team is automatically created.
​
identity
string
required
The unique identity string for the charger (e.g., serial number). Maximum 45 characters. Must be unique across all chargers.
​
team_uuid
string
The UUID of the team to assign the charger to. Must be a valid UUID of an existing team.
​
site_uuid
string
The UUID of the location to assign the charger to. Must be a valid UUID of an existing location.

​
Response

​
uuid
string
The unique UUID of the charger.
​
id
integer
The numeric ID of the charger.
​
identity
string
The unique identity string of the charger.
​
reference
string
A user-defined reference for the charger. May be null.
​
connection_status
string
The current connection status of the charger.
​
status
string
The current OCPP status of the charger.
​
created_at
string
ISO 8601 timestamp of when the charger was created.
​
updated_at
string
ISO 8601 timestamp of when the charger was last updated.
​
licenses
object
The charger’s active licenses.
​
permissions
object
The authenticated user’s permissions for this charger.