2026.6.3
Home ▸ Integrations

Rachio

The Rachio integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control your Rachio irrigation system.

There is currently support for the following device types within Home Assistant:

They will be automatically added if the Rachio integration is loaded.

Getting your Rachio API Key

  1. Log in at https://app.rach.io/.
  2. Go to Settings.
  3. Click Get API Key.
  4. Copy the API key from the dialog that opens.

Important

In order for Rachio switches and sensors to update, your Home Assistant instance must be accessible from the internet, either via Home Assistant Cloud or another method. See the Remote Access documentation for more information. The smart hose timers use polling and don’t require external access to be set up.

Configuration

To add the Rachio hub to your Home Assistant instance, use this My button:

Rachio can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

Water-saving suggestion:
After setting up the integration, change the options to set the duration in minutes to run when activating a zone switch to a maximum failsafe value when using scripts to control zones. If something goes wrong with your script, Home Assistant, or you hit the Rachio API rate limit of 1700 calls per day, the controller will still turn off the zone after this amount of time.

Smart hose timers

The Rachio smart hose timers are not currently capable of receiving real-time updates. Instead, they rely on polling. Because of this, the current state of valves started from a schedule or the physical button will not show up immediately. Polling occurs every 2 minutes when one base station is used, with an additional minute added for every additional base station to remain with the API rate limit. Up to 4 valves can be paired to a single base station.

Switch

The rachio switch platform allows you to toggle zones, valves, and schedules connected to your Rachio irrigation system on and off.

Once configured, a switch will be added for every zone that is enabled on every controller in the account provided, as well as a switch for each smart hose timer valve and a switch to start or stop every schedule on a controller. There will also be a switch to toggle each controller’s standby mode, as well as to activate a 24-hour rain delay on the device.

Calendar

A calendarA calendar entity represents a schedule of events coming from a local or external calendar source. It can be used to trigger automations based on the start or end of an event, react to offsets (like 15 minutes before), or retrieve event details through services. [Learn more] entity will be added for each smart hose timer base station on the account, which will show past and future events for all enabled schedules. An upcoming event can be deleted from the calendar, which will trigger a skip of that event.

List of actions

The Rachio integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

  • Pause watering (rachio.pause_watering) Pauses any currently running zones or schedules.

  • Resume watering (rachio.resume_watering) Resumes any paused zone runs or schedules.

  • Set zone moisture percent (rachio.set_zone_moisture_percent) Sets the moisture percentage of one or more sprinkler zones.

  • Start multiple zones (rachio.start_multiple_zone_schedule) Creates a custom schedule from a list of zones and run times.

  • Start watering (rachio.start_watering) Starts a single zone, a schedule, or any number of smart hose timer valves.

  • Stop watering (rachio.stop_watering) Stops any currently running zones or schedules.

For an overview of every action across all integrations, see the actions reference.

Examples

In this section, you find some real-life examples of how to use this switch.

groups.yaml example 

irrigation:
  name: Irrigation
  icon: mdi:water-pump
  view: true
  entities:
  - group.zones_front
  - group.zones_back
  - switch.side_yard
  - switch.every_day_6am

zones_front:
  name: Front Yard
  view: false
  entities:
  - switch.front_bushes
  - switch.front_yard

zones_back:
  name: Back Yard
  view: false
  entities:
  - switch.back_garden
  - switch.back_porch