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

# Create Charger

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.

<ParamField body="identity" type="string" required>
  The unique identity string for the charger (e.g., serial number). Maximum 45 characters. Must be unique across all chargers.
</ParamField>

<ParamField body="team_uuid" type="string">
  The UUID of the team to assign the charger to. Must be a valid UUID of an existing team.
</ParamField>

<ParamField body="site_uuid" type="string">
  The UUID of the location to assign the charger to. Must be a valid UUID of an existing location.
</ParamField>

## Response

<ResponseField name="uuid" type="string">
  The unique UUID of the charger.
</ResponseField>

<ResponseField name="id" type="integer">
  The numeric ID of the charger.
</ResponseField>

<ResponseField name="identity" type="string">
  The unique identity string of the charger.
</ResponseField>

<ResponseField name="serial_number" type="string">
  The serial number of the charger. May be `null`.
</ResponseField>

<ResponseField name="pincode" type="string">
  The charger's pincode. Only returned if the authenticated user has sensitive permissions.
</ResponseField>

<ResponseField name="reference" type="string">
  A user-defined reference for the charger. May be `null`.
</ResponseField>

<ResponseField name="connection_status" type="string">
  The current connection status of the charger.
</ResponseField>

<ResponseField name="status" type="string">
  The current OCPP status of the charger.
</ResponseField>

<ResponseField name="error" type="string">
  The current error code, if any. May be `null`.
</ResponseField>

<ResponseField name="error_info" type="string">
  Additional error information. May be `null`.
</ResponseField>

<ResponseField name="vendor_id" type="string">
  The vendor identifier. May be `null`.
</ResponseField>

<ResponseField name="vendor_error_code" type="string">
  A vendor-specific error code. May be `null`.
</ResponseField>

<ResponseField name="firmware_version" type="string">
  The raw firmware version string. May be `null`.
</ResponseField>

<ResponseField name="parsed_firmware_version" type="string">
  The parsed and normalized firmware version. May be `null`.
</ResponseField>

<ResponseField name="server" type="string">
  The OCPP server the charger is connected to. May be `null`.
</ResponseField>

<ResponseField name="last_connection_at" type="string">
  ISO 8601 timestamp of the last connection. May be `null`.
</ResponseField>

<ResponseField name="last_disconnection_at" type="string">
  ISO 8601 timestamp of the last disconnection. May be `null`.
</ResponseField>

<ResponseField name="last_heartbeat_at" type="string">
  ISO 8601 timestamp of the last heartbeat. May be `null`.
</ResponseField>

<ResponseField name="setup_pending" type="boolean">
  Whether the charger has a pending setup operation.
</ResponseField>

<ResponseField name="setup_completed" type="boolean">
  Whether the charger has completed initial setup.
</ResponseField>

<ResponseField name="blocked" type="boolean">
  Whether the charger is blocked.
</ResponseField>

<ResponseField name="max_current" type="number">
  The maximum current in Amperes the charger can deliver.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp of when the charger was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp of when the charger was last updated.
</ResponseField>

<ResponseField name="licenses" type="object">
  The charger's active licenses.

  <Expandable title="licenses">
    <ResponseField name="smart" type="boolean">
      Whether the smart charging license is active.
    </ResponseField>

    <ResponseField name="pro" type="boolean">
      Whether the pro license is active.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="model_id" type="integer">
  The ID of the charger model. May be `null`.
</ResponseField>

<ResponseField name="is_mid" type="boolean">
  Whether the charger is a MID-certified meter. May be `null`.
</ResponseField>

<ResponseField name="permissions" type="object">
  The authenticated user's permissions for this charger.

  <Expandable title="permissions">
    <ResponseField name="basic" type="boolean">
      Whether the user has basic read access.
    </ResponseField>

    <ResponseField name="sensitive" type="boolean">
      Whether the user has access to sensitive data (e.g., pincode, transactions).
    </ResponseField>

    <ResponseField name="full" type="boolean">
      Whether the user has full control (e.g., delete, transfer).
    </ResponseField>
  </Expandable>
</ResponseField>