- The key goes in the query string. Sensibo takes the API key as the
apiKeyquery parameter; the client sends no bearer token. Create a key at home.sensibo.com/me/api. With no key stored, Corsair raisesAuthMissingErrorbefore any request; a key Sensibo rejects comes back as HTTP 403. - Ask for the fields you need.
devices.listreturns only pod ids unless you passfields(*for everything, or a list such asid,room,acState,measurements). - AC values come from the pod’s remote. Valid
mode,fanLevel,swingandlightvalues are in the pod’sremoteCapabilities(devices.getwithfields: '*'). An AC state can be partial, such as{ on: false }. - Writes change a real air conditioner.
acStates.set, timers, schedules and Climate React act on the physical unit.timer.setandclimateReact.configurereplace the current timer or Climate React settings. - Unknown ids are 404. A pod or sensor that is not on the account answers 404 “No such device or device is not associated with user”.
- 19 typed API operations
- 1 synced entity (
pods) for fast.search()/.list()
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Sensibo API key before the first call: More: API Key
pnpm corsair setup --plugin=sensibo --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
List Sensibo pods with their rooms and AC stateQuery synced data
Synced entities supporttenant.sensibo.db.<entity>.search() and .list(): pods.
See Database for filters and operators.
What’s next
API reference
Every
sensibo.api.* operation with input and output types.Database
Synced entities, search filters, and operators.
Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.