Create a Thermostat Daily Program

• Request Parameters

• Response

Creates a new thermostat daily program. A daily program consists of a set of periods, where each period includes a start time and the key of a configured climate preset. Once you have defined a daily program, you can assign it to one or more days within a weekly program.

JavaScript

Creates a new thermostat daily program.

Code:

await seam.thermostats.dailyPrograms.create({
  device_id: "cc2d0fb9-1f5f-410f-80f1-a64b699de82a",
  name: "Weekday Program",
  periods: [
    { starts_at_time: "07:00:00", climate_preset_key: "Home" },
    { starts_at_time: "09:00:00", climate_preset_key: "Away" },
    { starts_at_time: "16:00:00", climate_preset_key: "Home" },
    { starts_at_time: "22:30:00", climate_preset_key: "Sleep" },
  ],
});

Output:

{
  "created_at": "2025-06-14T16:54:17.946642Z",
  "device_id": "cc2d0fb9-1f5f-410f-80f1-a64b699de82a",
  "name": "Weekday Program",
  "periods": [
    { "starts_at_time": "07:00:00", "climate_preset_key": "Home" },
    { "starts_at_time": "09:00:00", "climate_preset_key": "Away" },
    { "starts_at_time": "16:00:00", "climate_preset_key": "Home" },
    { "starts_at_time": "22:30:00", "climate_preset_key": "Sleep" }
  ],
  "thermostat_daily_program_id": "ab8ef74c-c7cd-4100-aa32-0ef960c0080d",
  "workspace_id": "8da8d923-e55b-45cd-84a3-6c96b3d3d454"
}

cURL

Creates a new thermostat daily program.

Code:

curl --include --request POST "https://connect.getseam.com/thermostats/daily_programs/create" \
  --header "Authorization: Bearer $SEAM_API_KEY" \
  --json @- <<EOF
{
  "device_id": "cc2d0fb9-1f5f-410f-80f1-a64b699de82a",
  "name": "Weekday Program",
  "periods": [
    {
      "starts_at_time": "07:00:00",
      "climate_preset_key": "Home"
    },
    {
      "starts_at_time": "09:00:00",
      "climate_preset_key": "Away"
    },
    {
      "starts_at_time": "16:00:00",
      "climate_preset_key": "Home"
    },
    {
      "starts_at_time": "22:30:00",
      "climate_preset_key": "Sleep"
    }
  ]
}
EOF

Output:

{
  "thermostat_daily_program": {
    "created_at": "2025-06-14T16:54:17.946642Z",
    "device_id": "cc2d0fb9-1f5f-410f-80f1-a64b699de82a",
    "name": "Weekday Program",
    "periods": [
      { "starts_at_time": "07:00:00", "climate_preset_key": "Home" },
      { "starts_at_time": "09:00:00", "climate_preset_key": "Away" },
      { "starts_at_time": "16:00:00", "climate_preset_key": "Home" },
      { "starts_at_time": "22:30:00", "climate_preset_key": "Sleep" }
    ],
    "thermostat_daily_program_id": "ab8ef74c-c7cd-4100-aa32-0ef960c0080d",
    "workspace_id": "8da8d923-e55b-45cd-84a3-6c96b3d3d454"
  }
}

Python

Creates a new thermostat daily program.

Code:

seam.thermostats.daily_programs.create(
    device_id="cc2d0fb9-1f5f-410f-80f1-a64b699de82a",
    name="Weekday Program",
    periods=[
        {"starts_at_time": "07:00:00", "climate_preset_key": "Home"},
        {"starts_at_time": "09:00:00", "climate_preset_key": "Away"},
        {"starts_at_time": "16:00:00", "climate_preset_key": "Home"},
        {"starts_at_time": "22:30:00", "climate_preset_key": "Sleep"},
    ],
)

Output:

ThermostatDailyProgram(
    created_at="2025-06-14T16:54:17.946642Z",
    device_id="cc2d0fb9-1f5f-410f-80f1-a64b699de82a",
    name="Weekday Program",
    periods=[
        {"starts_at_time": "07:00:00", "climate_preset_key": "Home"},
        {"starts_at_time": "09:00:00", "climate_preset_key": "Away"},
        {"starts_at_time": "16:00:00", "climate_preset_key": "Home"},
        {"starts_at_time": "22:30:00", "climate_preset_key": "Sleep"},
    ],
    thermostat_daily_program_id="ab8ef74c-c7cd-4100-aa32-0ef960c0080d",
    workspace_id="8da8d923-e55b-45cd-84a3-6c96b3d3d454",
)

Ruby

Creates a new thermostat daily program.

Code:

seam.thermostats.daily_programs.create(
  device_id: "cc2d0fb9-1f5f-410f-80f1-a64b699de82a",
  name: "Weekday Program",
  periods: [
    { starts_at_time: "07:00:00", climate_preset_key: "Home" },
    { starts_at_time: "09:00:00", climate_preset_key: "Away" },
    { starts_at_time: "16:00:00", climate_preset_key: "Home" },
    { starts_at_time: "22:30:00", climate_preset_key: "Sleep" },
  ],
)

Output:

{
  "created_at" => "2025-06-14T16:54:17.946642Z",
  "device_id" => "cc2d0fb9-1f5f-410f-80f1-a64b699de82a",
  "name" => "Weekday Program",
  "periods" => [
    { starts_at_time: "07:00:00", climate_preset_key: "Home" },
    { starts_at_time: "09:00:00", climate_preset_key: "Away" },
    { starts_at_time: "16:00:00", climate_preset_key: "Home" },
    { starts_at_time: "22:30:00", climate_preset_key: "Sleep" },
  ],
  "thermostat_daily_program_id" => "ab8ef74c-c7cd-4100-aa32-0ef960c0080d",
  "workspace_id" => "8da8d923-e55b-45cd-84a3-6c96b3d3d454",
}

PHP

Creates a new thermostat daily program.

Code:

$seam->thermostats->daily_programs->create(
    device_id: "cc2d0fb9-1f5f-410f-80f1-a64b699de82a",
    name: "Weekday Program",
    periods: [
        ["starts_at_time" => "07:00:00", "climate_preset_key" => "Home"],
        ["starts_at_time" => "09:00:00", "climate_preset_key" => "Away"],
        ["starts_at_time" => "16:00:00", "climate_preset_key" => "Home"],
        ["starts_at_time" => "22:30:00", "climate_preset_key" => "Sleep"],
    ]
);

Output:

[
    "created_at" => "2025-06-14T16:54:17.946642Z",
    "device_id" => "cc2d0fb9-1f5f-410f-80f1-a64b699de82a",
    "name" => "Weekday Program",
    "periods" => [
        ["starts_at_time" => "07:00:00", "climate_preset_key" => "Home"],
        ["starts_at_time" => "09:00:00", "climate_preset_key" => "Away"],
        ["starts_at_time" => "16:00:00", "climate_preset_key" => "Home"],
        ["starts_at_time" => "22:30:00", "climate_preset_key" => "Sleep"],
    ],
    "thermostat_daily_program_id" => "ab8ef74c-c7cd-4100-aa32-0ef960c0080d",
    "workspace_id" => "8da8d923-e55b-45cd-84a3-6c96b3d3d454",
];

Seam CLI

Creates a new thermostat daily program.

Code:

seam thermostats daily-programs create --device_id "cc2d0fb9-1f5f-410f-80f1-a64b699de82a" --name "Weekday Program" --periods [{"starts_at_time":"07:00:00","climate_preset_key":"Home"},{"starts_at_time":"09:00:00","climate_preset_key":"Away"},{"starts_at_time":"16:00:00","climate_preset_key":"Home"},{"starts_at_time":"22:30:00","climate_preset_key":"Sleep"}]

Output:

{
  "created_at": "2025-06-14T16:54:17.946642Z",
  "device_id": "cc2d0fb9-1f5f-410f-80f1-a64b699de82a",
  "name": "Weekday Program",
  "periods": [
    { "starts_at_time": "07:00:00", "climate_preset_key": "Home" },
    { "starts_at_time": "09:00:00", "climate_preset_key": "Away" },
    { "starts_at_time": "16:00:00", "climate_preset_key": "Home" },
    { "starts_at_time": "22:30:00", "climate_preset_key": "Sleep" }
  ],
  "thermostat_daily_program_id": "ab8ef74c-c7cd-4100-aa32-0ef960c0080d",
  "workspace_id": "8da8d923-e55b-45cd-84a3-6c96b3d3d454"
}

Authentication Methods

• API key

• Client session token

• Personal access token Must also include the seam-workspace header in the request.

To learn more, see Authentication.

Request Parameters

device_id String (Required)

ID of the thermostat device for which you want to create a daily program.

---

name String (Required)

Name of the thermostat daily program.

---

periods Array of Objects (Required)

Array of thermostat daily program periods.

---

Response

thermostat_daily_program

JSON

{
  "created_at": "2025-06-14T16:54:17.946642Z",
  "device_id": "58437d45-47ac-4ee6-ab27-7b2d1f2947d1",
  "name": "Weekday Program",
  "periods": [
    { "starts_at_time": "07:00:00", "climate_preset_key": "Home" },
    { "starts_at_time": "09:00:00", "climate_preset_key": "Away" },
    { "starts_at_time": "16:00:00", "climate_preset_key": "Home" },
    { "starts_at_time": "22:30:00", "climate_preset_key": "Sleep" }
  ],
  "thermostat_daily_program_id": "ab8ef74c-c7cd-4100-aa32-0ef960c0080d",
  "workspace_id": "8da8d923-e55b-45cd-84a3-6c96b3d3d454"
}