Skip to main content
POST
/
v3
/
sites
/
join
Request to Join
curl --request POST \
  --url https://app.plugchoice.com/api/v3/sites/join \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identity": "<string>",
  "pincode": 123,
  "team_uuid": "<string>"
}
'
{
  "message": "<string>",
  "site_id": 123,
  "site_uuid": "<string>",
  "site_name": "<string>",
  "team_uuid": "<string>"
}
Joins a location using a charger’s identity and pincode. This allows users to gain access to a location by proving they have physical access to one of its chargers.
​
identity
string
required
The OCPP identity of a charger belonging to the location. Maximum 255 characters.
​
pincode
number
required
The pincode of the charger.
​
team_uuid
string
required
The UUID of the team to join the location with. The authenticated user must be a member of this team.

​
Response

​
message
string
A confirmation message indicating the location was joined successfully.
​
site_id
integer
The numeric ID of the location that was joined.
​
site_uuid
string
The UUID of the location that was joined.
​
site_name
string
The name of the location that was joined.
​
team_uuid
string
The UUID of the team that joined the location.