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
  }
}
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.