Skip to main content

Overview

This guide walks you through connecting your Cielo devices to Seam with a Cielo API key. Each Cielo device must already be installed, connected to Wi-Fi, and working in the Cielo Home app before you start.

Step 1: Create a Cielo API Key

  1. Sign in at home.cielowigle.com with the Cielo account to which the devices are registered.
  2. Open the menu at the top left and choose Home Assistant.
  3. Copy the API key that appears.
Cielo lets each API key connect to only one app. Don’t use the key anywhere else, and create a new key if it was already used, including in an earlier attempt to connect to Seam. A Cielo account can create only a few API keys in a 30-day period, so keep this key for Seam.

Step 2: Connect via Connect Webview

  1. Open the Connect Webview provided by your application.
  2. Select Cielo as the provider.
  3. Paste the API key and click Submit.

Step 3: Verify the Connection

After connecting, verify that each Cielo device appears as a thermostat and shows as online. Each device lists the HVAC modes that it supports, such as heat, cool, and off.

Disconnecting

To stop Seam from accessing a Cielo account, delete the connected account in Seam. To connect the account again later, create a new API key.

Troubleshooting

The Connect Webview doesn’t accept the API key

  • Check that you copied the whole key.
  • Create a new key at home.cielowigle.com and try again. A key that was already used, even by an attempt that failed, can’t connect again.

Devices don’t appear after connecting

  • Verify that each device is online in the Cielo Home app.
  • Confirm that you created the API key with the Cielo account to which the devices are registered.
  • Seam lists only Cielo devices that heat or cool. A device that controls a fan-only unit doesn’t appear.

A device shows as offline

Seam reports a device as offline when Cielo does. Check the device’s Wi-Fi connection in the Cielo Home app. Seam rejects commands to an offline device until it reconnects.

The air conditioner doesn’t respond to a command

  • Check that the same command works from the Cielo Home app.
  • For a Breez controller, make sure that nothing blocks the line of sight between the controller and the air conditioner.