MAP Energy Help & Documentation
Automation Guide
MAP Energy

Automations

Automations let MAP Energy respond to schedules, battery levels, EV charging, smart tariff events and energy conditions automatically — or pass those events into Home Assistant to extend your automations across your home.

Mappy, the MAP Energy assistant

What are MAP Energy automations?

MAP Energy automations allow you to create rules that monitor your energy system and perform an action when a particular event or condition occurs.

An automation is built around a simple idea: when something happens, MAP Energy performs the action you have configured.

1 Trigger
→
2 Check conditions
→
3 Run action
i
Automations run in the background

Once an automation has been created and enabled, MAP Energy monitors it through the MAP Energy service. You do not need to keep the mobile app open for an automation to run.

Manage automations in the Web Portal

With Premium, open Automations in the Web Portal to manage the same rules saved by the mobile app.

  1. Select Add automation or Edit on an existing rule.
  2. Choose Schedule, EV, Battery, Price, Power, Solar, Power Hour or Power Perks, where available for your site.
  3. Set the trigger details and any time window or blocking condition, then choose up to four compatible actions. A name is optional and can contain up to 20 characters.
  4. Select Add automation or Save changes. Editing keeps the existing rule; a paused automation remains paused.

Pause / Resume is supported for EV, battery, price, power, solar forecast and Power Perks rules, and for repeating schedules. One-off schedules and Power Hour rules do not offer pause/resume. To remove a rule, open Edit, select Delete automation, then Confirm delete.

Schedules use the energy site’s time zone. Choose days, a time, and whether to repeat with an end date or no end date. The Run Log shows recent results; Needs attention filters failed, partial and blocked runs.

Connections and dedicated Intelligent Octopus Go / EDF Smart Bolt-On setup remain in the mobile app. Their automatically managed rules are not ordinary editable portal rules. Home Assistant actions become available after the webhook is connected.

Automation triggers

The trigger determines when MAP Energy should evaluate and run your automation. Automations require MAP Energy Premium and the connections needed by the selected trigger and actions.

◷

Schedule

Run an automation at a selected time and on the days you choose.

⚡

EV charging

Respond when charging starts or stops on a supported EV or charger integration.

◉

Battery

Trigger when your Powerwall state of charge rises above or falls below a selected level.

£

Electricity price

Respond when an available import or export price moves above or below your selected threshold.

↕

Power & energy

Respond to supported grid import, grid export or other monitored power thresholds. Choose the direction and threshold offered by your connected system.

☀

Solar

Respond to supported solar generation conditions or a solar forecast above or below a selected energy threshold. Forecast energy and current generation power describe different things; check the units shown in the app.

Smart tariff & supplier events

MAP Energy can also use supported smart tariff and supplier events as part of your energy automation strategy.

Where a compatible supplier, tariff or feature has been detected, MAP Energy can provide dedicated automation options so that your Powerwall or connected services can respond to those events automatically.

Octopus Energy

Intelligent Octopus Go

Enable MAP Energy automation behaviour around supported Intelligent Octopus Go smart charging periods.

EDF

Smart Bolt-On

Respond to supported EDF Smart Bolt-On charging events, including the start and end of smart charging.

EDF

Power Perks

Use supported EDF Power Perks events within MAP Energy when Power Perks automation is enabled.

i
Availability depends on your account

Smart tariff and supplier automation options are shown where MAP Energy has the required supplier connection, tariff information or supported feature for your account.

Choose the right trigger

  • Power monitors a kW threshold for Home, Solar, Import, Export, PW Charge or PW Discharge.
  • Solar checks forecast generation in kWh at a chosen daily time. One solar forecast automation is supported per site.
  • Power Hour uses selected days, start/end times, an import cap and a trigger threshold at or below that cap. It is unavailable for an Other (Blind) charger setup where total import cannot be measured safely.
  • Power Perks offers Event Announced, Free Electricity Starts and Free Electricity Ends for a registered EDF site.

EV, battery, price and power triggers can use an optional time window. Schedule rules can use a blocking condition based on battery SOC or import/export price; price conditions also have a look-ahead window. Availability follows the selected trigger rather than every condition being offered for every rule.

Conditions and time windows

A trigger tells MAP Energy when something has happened. Conditions can provide an additional check before the configured action is allowed to run.

Depending on the automation type, you can restrict when an automation is allowed to operate or prevent an action when another energy condition is not suitable.

Example
When EV charging starts
Check Whether charging started inside the allowed time window
Then Adjust the Powerwall backup reserve

Time windows can also be used where available so that an event-triggered automation only acts during the period that is relevant to you.

Automation actions

The action determines what MAP Energy should do after the automation has triggered and any required conditions have been satisfied.

%

Adjust Backup Reserve

Change the Tesla Powerwall backup reserve to a selected percentage, or restore a previously captured reserve where supported.

❄

Freeze Battery SOC

Preserve the battery state of charge by temporarily controlling the Powerwall reserve.

⇧

Export Control

Change the supported Powerwall energy export setting when your system permits it.

◈

Operational Mode

Change the Powerwall operating mode using the modes supported by your system.

↯

Grid Charging

Enable or disable Powerwall grid charging when the setting is available for your system.

!

Notification Only

Receive an alert when a trigger occurs without changing any Powerwall settings.

⌂

Home Assistant Webhook

Send the automation event to your connected Home Assistant instance so that Home Assistant can respond using its own automations, devices and services.

i
Available options depend on your system

Some triggers and actions require a compatible Powerwall, tariff, EV charger, Home Assistant connection or other connected service. MAP Energy only presents options that are applicable to the integrations available to your account.

Home Assistant webhooks

If you have connected Home Assistant to MAP Energy, a Home Assistant Webhook can be selected as an automation action.

Instead of changing a Powerwall setting directly, MAP Energy sends information about the event to your Home Assistant webhook. Home Assistant can then use that information as the starting point for its own automation.

⌂
MAP Energy → Home Assistant

This allows a MAP Energy event to extend beyond your Powerwall. For example, Home Assistant could respond by controlling another compatible device, running a scene, sending its own notification or starting another Home Assistant automation.

Example
When EDF Smart Bolt-On smart charging starts
Then Send a Home Assistant webhook event
HA Home Assistant receives map_energy_smart_charging_started

What does Home Assistant receive?

MAP Energy sends a structured payload containing information about the automation, trigger and event that caused the webhook to be sent.

The following is an anonymised example of a webhook generated when an EDF Smart Bolt-On smart charging session started.

Event
map_energy_smart_charging_started
Message
EDF Smart Bolt-On smart charging started.
Automation
Smart Bolt-On Start
Action
home_assistant_event
Trigger
EV — starts_charging
Source
map_energy
Example webhook payload JSON
{
  "schema_version": 1,
  "type": "map_energy.automation_event",
  "source": "map_energy",

  "event": "map_energy_smart_charging_started",
  "event_name": "map_energy_smart_charging_started",

  "event_id": "example-event-id",

  "occurred_at": "2026-09-25T23:01:48.421Z",

  "site_key": "example-site-key",

  "automation": {
    "name": "Smart Bolt-On Start",
    "action_type": "home_assistant_event",
    "grouped": true
  },

  "trigger": {
    "type": "ev",
    "event": "starts_charging"
  },

  "message": "EDF Smart Bolt-On smart charging started.",

  "data": {}
}
i
Identifiers shown above are examples

The event ID and site key in this documentation have been replaced with example values. Your webhook payload will contain identifiers generated for the actual MAP Energy event and site.

Understanding the webhook payload

The payload is designed to give Home Assistant enough context to decide what should happen next.

event

A machine-readable MAP Energy event name that can be used to identify what happened.

message

A human-readable description of the event.

automation

Information about the MAP Energy automation that generated the webhook.

trigger

Describes the trigger type and, where applicable, the specific event that caused the automation to run.

occurred_at

The timestamp showing when the MAP Energy event occurred.

data

Additional event-specific information can be provided here when required.

Mappy
Mappy tip

In Home Assistant, use a webhook-triggered automation and inspect the incoming JSON event field before choosing an action. The MAP Energy event name is a value in that payload; receiving a webhook does not by itself fire an event with that name on the Home Assistant event bus.

Common automation ideas

Automations can be combined in different ways depending on how you use your Powerwall, EV, electricity tariff and connected services.

Protect the Powerwall while charging an EV
When EV charging starts
Then Preserve the Powerwall battery state of charge
Restore the battery after EV charging
When EV charging stops
Then Restore your preferred backup reserve
Charge the Powerwall overnight
When Your selected overnight time begins
Then Adjust the Powerwall settings for your charging strategy
Smart charging into Home Assistant
When A supported smart charging event begins
Then Send the event to Home Assistant
HA Run your own Home Assistant automation or control another connected device
React to electricity prices
When Your electricity price moves above or below your selected threshold
Then Change the configured Powerwall setting or send the event to Home Assistant

Backup reserve automations

Backup reserve is one of the most useful Powerwall controls available to MAP Energy automations.

It can be used to preserve stored energy, encourage charging or return your Powerwall to your normal reserve after another automation has completed.

Tesla does not support backup reserve values between 81% and 99%. MAP Energy has been designed with this restriction in mind and will not intentionally submit an unsupported reserve value to Tesla.

MAP Energy handles unsupported reserve values

Where an automation captures your current reserve for later restoration, MAP Energy allows you to choose whether 80% or 100% should be used if the captured value falls within Tesla's unsupported 81–99% range.

Using multiple actions

Some energy strategies require more than one action to take place together.

MAP Energy supports up to four compatible actions in one automation. Each action type can appear once. Notification Only must be used on its own and is not offered for a custom schedule. Adjust Backup Reserve and Freeze Battery SOC cannot be combined in the same rule.

This can include Powerwall controls as well as connected actions such as sending the event to Home Assistant.

Example
When Smart charging starts
Then Apply the configured Powerwall behaviour and send the event to Home Assistant

Automation history

MAP Energy records automation activity so that you can see what happened after an automation was due to run.

Automation history can show successful actions as well as blocked or failed runs, helping you understand why a particular action did or did not take place.

Mappy
Mappy tip

If an automation does not appear to have worked, check its history first. MAP Energy records the result of the run and, where available, the reason an action was blocked or failed.

What happens if an action fails?

MAP Energy relies on connected services such as Tesla, supported EV or energy providers and user-configured integrations to carry out some automation actions.

Temporary service availability, API errors or communication problems can occasionally prevent an action from completing. MAP Energy includes execution and retry handling for supported actions, and the result is recorded in your automation history.

A successful history entry is intended to represent a successfully completed action rather than simply the automation having reached its scheduled time.

Does the MAP Energy app need to stay open?

No. MAP Energy automations are processed by the MAP Energy service, so closing the app, closing the portal or locking your phone does not stop your enabled automations from running.

Need help?

If an automation is not behaving as expected, start by checking its configuration and automation history in MAP Energy.

The history can help identify whether the automation triggered, whether a condition prevented it from running, or whether a connected service returned an error.

You can also contact MAP Energy support if you need help diagnosing an automation or connected service.