List autocharge vehicles

The List autocharge vehicles action retrieves the vehicles stored in the Peblar charger’s autocharge list. The action returns the list as response data, which you can use in an automation or script to inspect which cars are allowed to charge.

Autocharge lets a car authorize itself. The charger recognizes the identifier the car’s own controller presents when it is plugged in, so no card or app is needed.

Note

Autocharge is only available on Peblar chargers that are equipped with power line communication hardware.

Try it yourself

Ready to test this? Open Settings > Tools > Actions, search for this action, fill in the fields, and select Perform action. You see what happens on your actual entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] without writing a line of YAML.

Using this action from the user interface

If you prefer building automations and scripts visually, Home Assistant walks you through this action step by step. You pick what to target, tweak a few options, and save. No YAML knowledge required.

To retrieve the autocharge list from an automation or a script:

  1. Go to Settings > Automations & scenes.
  2. Open an existing automation or script, or select Create to start a new one.
  3. In the Then do section, select Add action.
  4. From the search box, search for and select Peblar: List autocharge vehicles.
  5. Under Peblar EV charger, select the Peblar charger to retrieve the vehicles from.
  6. Select Save.

Options in the UI

Peblar EV charger (Required)

The Peblar EV charger to list autocharge vehicles for.

Using this action in YAML

If you work directly in YAML, or you want to know exactly what Home Assistant does under the hood, this section has the technical reference. It lists the field names you use in YAML, their types, and which ones are required.

In YAML, refer to this action as peblar.list_vehicle_tokens. A basic example looks like this:

ActionAn action makes Home Assistant do something, for example, turn on a light, send a notification, or activate a scene. Automations and scripts run a list of actions. [Learn more]
action: peblar.list_vehicle_tokens
data:
  config_entry_id: "01234567890abcdef01234567890abcd"

Options in YAML

config_entry_id string Required

The ID of the Peblar charger config entry to list autocharge vehicles for.

Response data

The action returns an object with a single vehicles member. Each vehicle has an evcc_id and an alias:

vehicles:
  - evcc_id: "NL-ABC-0123456789-1"
    alias: "The blue one"
  - evcc_id: "NL-ABC-9876543210-2"
    alias: "The other one"

Good to know

  • Only administrators can run this action.
  • An identifier belongs to a specific car, so treat it the way you would any other credential.

More examples

Real scenarios where this action shows up in automations and scripts. Copy any example and adapt it to your setup.

Tip

You don’t need to edit YAML to use these examples. Copy a YAML snippet from this page, open the automation editor in Home Assistant, and press Ctrl+V (or Cmd+V on Mac). Home Assistant automatically converts the pasted YAML into the visual editor format, whether it’s a full automation, a single trigger, a condition, or an action.

Automation: send a notification with the current autocharge list

Retrieve the configured vehicles and send yourself a summary as a notification.

YAML example for notifying with the autocharge list
AutomationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more]
triggers:
  - trigger: time
    at: "08:00:00"
actions:
  - action: peblar.list_vehicle_tokens
    data:
      config_entry_id: "01234567890abcdef01234567890abcd"
    response_variable: autocharge_list
  - action: notify.mobile_app_your_phone
    data:
      title: "Peblar autocharge vehicles"
      message: >
        Currently allowed to charge:
        {{ autocharge_list.vehicles | map(attribute='alias') | join(', ') }}

Still stuck?

The Home Assistant community is quick to help: join Discord for real-time chat, post on the community forum with the action you’re calling and what you expected to happen, or share on our subreddit /r/homeassistant.

Tip

AI assistants like ChatGPT or Claude can also explain actions or suggest the right one when you describe what you want in plain language.