Skip to main content
POST
/
v3
/
chargers
/
{charger}
/
setup
Setup Charger
curl --request POST \
  --url https://app.plugchoice.com/api/v3/chargers/{charger}/setup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phases": 123,
  "max_current": 123,
  "group": 123,
  "net_type": "<string>",
  "phase_rotation": "<string>"
}
'
{
  "message": "<string>",
  "setup_pending": 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.

Configures initial settings for a charger including phases, current limits, and other configuration. The charger will automatically restart after a successful setup. This endpoint is rate limited to 1 request per 60 seconds per charger.
​
charger
string
required
The UUID of the charger to set up.
​
phases
integer
required
The number of phases. Must be 1 or 3.
​
max_current
integer
required
The maximum current in Amperes. Must be at least 6.
​
group
integer
The location group ID to assign the charger to. Must reference an existing location group.
​
net_type
string
The electrical network type. One of IT, TT, TN, or unknown.
​
phase_rotation
string
The phase rotation configuration. The length must match the number of phases. Valid values for 3 phases: RST, RTS, SRT, STR, TRS, TSR. Valid values for 1 phase: R, S, T.

​
Response

​
message
string
A success message indicating the charger will restart.
​
setup_pending
boolean
Whether the setup is still pending.