> ## Documentation Index
> Fetch the complete documentation index at: https://www.seam.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cielo Setup Guide

> Connect your Cielo smart thermostats and Breez air conditioner controllers to Seam. Create a Cielo API key and enter it in a Connect Webview to set up your integration.

## 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](https://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.

> [!WARNING]
>
> 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](https://www.seam.co/docs/core-concepts/connect-webviews.md) 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](https://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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.