heat_cool. Check the Cielo-specific restrictions before you build.
The Cielo integration is in beta. To enable it for your workspaces, contact Seam support.
Step 1: Install a Seam SDK
Seam provides client libraries for many languages, including JavaScript, Python, Ruby, PHP, and others, as well as a Postman collection and an OpenAPI spec.- JavaScript / TypeScript (npm, GitHub)
- Python (pip, GitHub)
- Ruby Gem (rubygem, GitHub)
- PHP (packagist, GitHub)
- C# (nuget, GitHub)
- JavaScript
- Python
- Ruby
- PHP
- C#
This guide uses a sandbox
workspace. You can only connect
virtual devices and systems in this type of workspace. If you want to connect
a real Cielo device, use a non-sandbox
workspace and API key.
Step 2: Link your Cielo account with Seam
To control your Cielo devices using the Seam API, you must first authorize your Seam workspace to connect to your Cielo account. If your application needs to connect to your users’ Cielo accounts, Seam provides fully-embedded, customizable client-side Connect Webviews to collect their authorization securely. Cielo connects through an API key instead of a password. Your user creates the key at home.cielowigle.com and pastes it into the Connect Webview. For the steps your users follow, see the Cielo setup guide.This guide shows you how to create a Connect Webview programmatically using the Seam API.The Seam Console provides another easy way to connect devices to your Seam workspace.Go to https://console.seam.co/. On the Devices page, click + Add Devices. Then, see Authorize your workspace in this guide to complete the Connect Webview authorization flow.
Create a Connect Webview
Create aconnect_webview object and then note the returned URL.
The C# examples in this guide send requests to the Seam API directly.
Code:
Authorize Your Workspace
In a web browser, go to the URL that the Connect Webview object returned. For application developers, you can redirect your user to this Connect Webview URL so that they can authorize your app to control their devices using Seam. We even provide a prebuilt Connect Account Button within our suite of Seam Components that help you build your device management flow.Because you’re using a sandbox workspace, you connect Seam’s test Cielo
account. We provide virtual devices for each of
the brands that we support. These sandbox devices and systems enable you to
test your app with devices from multiple brands without the need to own all
the corresponding physical devices.
- In the Connect Webview, paste the Cielo sandbox API key,
1234. - Click Submit.
Step 3: Retrieve Cielo thermostat devices
When you link a Cielo account with Seam, we create adevice object for each Cielo device in the account that heats or cools. Devices that control a fan-only unit don’t appear. You can retrieve these devices using the List Devices and Get Device endpoints.
The device’s device_type is cielo_thermostat, and properties.cielo_metadata identifies the Cielo device by its name and MAC address. The device also reports the room’s temperature and humidity, its current climate setting, its supported HVAC modes, and its set point range.
Code:
Step 4: Control your Cielo thermostat
Each device that you connect to Seam has a specific set of capabilities. Capability flags tell your application what each device supports. For Cielo, checkcan_hvac_heat, can_hvac_cool, and can_hvac_heat_cool before you send a command. Most Breez devices support heat, cool, and off, and a Cielo Smart Thermostat also supports heat_cool.
Try out the following actions on your Cielo device:
Set the HVAC mode
To set the HVAC mode, use any of the following endpoints or their equivalents in the Seam SDKs:/thermostats/heat/thermostats/cool/thermostats/off/thermostats/set_hvac_mode
device_id in the request body. Also, include the desired temperature set point. The set point must be within the device’s range, such as min_heating_set_point_celsius and max_heating_set_point_celsius.
In this example, set the Living Room Mini Split to heat with a heating set point of 21 °C. Each of these HVAC mode endpoints returns an action attempt to track the progress of the operation.
Code:
Native SDK action methods and Seam CLI commands wait for the action attempt automatically. Raw HTTP
calls do not. If you use raw HTTP, poll until the action attempt is no longer
pending. See
Action Attempts.
Verify the change
Confirm that the action attempt succeeded, then get the device and readproperties.current_climate_setting. Its hvac_mode_setting and heating_set_point_celsius show what Cielo reports for the device. properties.temperature_celsius is the room’s measured temperature, not the set point.
Code:
Create and schedule climate presets
You can use the Seam API to create climate presets for Cielo devices. Each climate preset is a saved group of settings, such as the HVAC mode and set point. For example, you could create a comfort preset for when a vacation rental is occupied and an eco preset for when it’s empty. You can schedule climate presets to start and stop whenever you’d like, and set a fallback climate preset that applies outside your schedules. Because Seam doesn’t support fan modes for Cielo, leave outfan_mode_setting when you create a Cielo climate preset.
In this example, create comfort and eco presets for the Living Room Mini Split, set eco as the fallback, and schedule the comfort preset for a guest’s stay.
Code:
Step 5: Connect a real Cielo device
Now that you have learned the basics of using the Seam API, you can connect and control a real Cielo device. To do so, switch to a non-sandbox workspace and API key. For the steps your users follow to create a Cielo API key and connect it, see the Cielo setup guide.Step 6: Build your application!
The Seam API and Seam SDKs give you up-to-date information about your thermostats. Seam also sends thermostat-related events that let you monitor your thermostats and the connected heating and cooling systems. Our simulation endpoints help you test your app against events that are hard to reproduce with real devices.Next steps
Now that you’ve completed this getting started guide for Cielo devices, you can learn more about what you can do with the Seam API.- Explore
See the other devices and system integrations that Seam supports. - Learn
Read about Seam concepts and the device and system capabilities that Seam supports. - Expand your abilities
Find out what other thermostat actions you can perform using the Seam API. - Use webhooks
Learn how to use webhooks as an efficient way to receive device events.
If you have any questions or want to report an issue, email us at
support@seam.co.
Quick links

Get an API Key (free)
Sign up for the Seam Console and get your API keys. →

Contact Sales
Got a project or a specific question? Contact our team to get answers. →