Buildings and data sources
Create a building
Creates a building in your organization. The building starts unpublished, with no products enabled.
POST
Create a building
A new building has every product turned off. Until the
api product is enabled for it, calls that name the building return 403, including Get a building, Create a KODE API connector, and Update a building. The API cannot enable products. Your KODE project team enables the api product for a new building by hand, so ask them before you call the building, and allow for that step if you automate building creation.Required fields
Optional fields
What the API sets for you
- The API looks up the
addressto find the building location. The response carries the location, the state and country codes, and the time zonetz. If the address cannot be located, the request fails with400. Checkaddress1,city,zip, andcountry. publishedisfalse. Use Set the status of a building to change it.productslists the products withenabledset tofalse, and the counts andstatsstart at0.
baseTemp in °F whatever unit you use in KODE OS.Authorizations
Paste an access token from Create an access token. Tokens expire, so request a new one if you receive 401.
Body
application/json
Maximum string length:
50Pattern:
\SPattern:
\SRequired range:
1600 <= x <= 2100Required range:
x >= 0Maximum string length:
255Maximum string length:
255Maximum string length:
255Maximum string length:
255Maximum string length:
255Response
The created building.
Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.
Example:
"2026-10-28T13:51:31+0000"
Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.
Example:
"2026-10-28T13:51:31+0000"

