SpriggDocs
Open App

Integrations

Sprigg integrates with popular smart irrigation controllers and weather stations to monitor and control your lawn's watering automatically. This page covers how to set up and troubleshoot each integration.

Rachio

Rachio is a Wi-Fi-enabled smart sprinkler controller. Sprigg connects to Rachio via its REST API to read zone data, start/stop watering, and pull run history.

Setup

  1. Open the Rachio app on your phone or visit app.rach.io
  2. Go to Account Settings
  3. Find API Key (you may need to request one if you haven't before)
  4. Copy the API key
  5. In Sprigg, go to Settings → Integrations → Rachio
  6. Paste your API key and click Save
  7. Click Sync to import your device and zones

What Gets Synced

When you sync your Rachio device, Sprigg imports:

  • Device info — Name, model, status
  • Zones — All enabled zones with their configuration
  • Zone details — Soil type, nozzle type, precipitation rate, shade, slope, root depth
  • Coordinates — Device location (auto-fills your property coordinates if not set)

Zone data is cached in the database for 6 hours and API responses are cached in-memory for 5 minutes to avoid excessive API calls. If the Rachio API is rate-limited (429 response), Sprigg falls back to cached data gracefully.

Capabilities

  • Start individual zones or multiple zones in sequence
  • Stop all zones on a device
  • Set rain delays (in days)
  • Query device events and run history
  • Check current running schedule
Note: When Sprigg is in Active mode, it will put your Rachio device into standby mode, disabling all existing schedules, weather intelligence, and water budgeting to prevent double-watering. Sprigg's AI-driven recommendations fully replace your Rachio's built-in features.

Orbit B-Hyve

Orbit B-Hyve is a Wi-Fi sprinkler timer that Sprigg connects to via REST API for data and WebSocket for real-time zone control.

Setup

  1. In Sprigg, go to Settings → Integrations → Orbit B-Hyve
  2. Enter your B-Hyve account email and password
  3. Click Save
  4. Click Sync to import your device and zones

What Gets Synced

  • Device info — Name, model, status
  • Zones — All configured zones
  • Zone details — Landscape type, sprinkler type (mapped to precipitation rates and nozzle types)
  • Watering events — Historical run data
Tip: B-Hyve provides less detailed zone metadata than Rachio. Consider adding descriptions to your zones in Settings → Zones to help the AI understand each zone's characteristics (sun exposure, slope, soil type).

Capabilities

  • Start and stop zones via WebSocket commands
  • Query watering event history
  • Automatic re-authentication on token expiration

How Zone Control Works

Unlike Rachio (which uses simple REST API calls), B-Hyve zone control uses a WebSocket connection. When Sprigg needs to start or stop a zone:

  1. Opens a WebSocket connection to the B-Hyve API
  2. Authenticates with your stored credentials
  3. Sends the zone command
  4. Waits for confirmation (with timeout handling)
  5. Closes the connection

WeatherFlow Tempest

The WeatherFlow Tempest is a personal weather station that provides hyper-local weather data. If you have one installed at your property, connecting it gives Sprigg more accurate data than regional weather forecasts.

Setup

  1. Log in to your WeatherFlow Tempest account
  2. Find your Station ID and generate an API key
  3. In Sprigg, go to Settings → Integrations → WeatherFlow Tempest
  4. Enter your Station ID and API key
  5. Click Save

What It Provides

  • Temperature — Ground-truth readings from your property
  • Humidity — Local humidity data
  • Wind — Speed and direction
  • Rainfall — Precise precipitation measurements (used as primary rainfall source when available)
  • Pressure — Barometric pressure

When a Tempest station is connected, Sprigg prioritizes its data over regional weather APIs for current conditions and recent rainfall. This is especially valuable for rainfall tracking, where localized measurements are far more accurate than weather service estimates.

Security

All integration credentials (API keys, passwords) are encrypted at rest in the database using AES encryption. Credentials are decrypted only when needed to make API calls and are never exposed in the UI after initial entry. You can update or remove credentials at any time from the Integrations settings page.

Troubleshooting

Sync fails or shows no zones

  • Verify your API key or credentials are correct
  • Ensure your controller is online and connected to Wi-Fi
  • Check that you have at least one enabled zone on your controller
  • Try syncing again after a few minutes — the controller API may be temporarily unavailable

Zone commands not executing

  • Confirm your irrigation mode is set to Active
  • Check that the zone is not currently in a rain delay on the controller
  • Verify the controller is powered on and online
  • Check the decision history for any error messages

Stale data or cached results

Zone data is cached for 6 hours (Rachio) to reduce API calls. If you've made changes to your controller configuration, click Sync to force a refresh.