Create a Noise Threshold

• Request Parameters

• Response

Creates a new noise threshold for a noise sensor. Thresholds represent the limits of noise tolerated at a property, which can be customized for each hour of the day. Each device has its own default thresholds, but you can use the Seam API to modify them.

JavaScript

Creates a new noise threshold for a noise sensor.

Code:

await seam.noiseSensors.noiseThresholds.create({
  device_id: "8282891b-c4da-4239-8f01-56089d44b80d",
  name: "My Noise Sensor",
  starts_daily_at: "2025-06-20T18:29:57.000Z",
  ends_daily_at: "2025-06-19T12:38:44.000Z",
  noise_threshold_decibels: 50,
  noise_threshold_nrs: 40,
});

Output:

{
  "device_id": "8282891b-c4da-4239-8f01-56089d44b80d",
  "ends_daily_at": "2025-06-19T12:38:44.000Z",
  "name": "My Noise Sensor",
  "noise_threshold_decibels": 50,
  "noise_threshold_id": "f8cef69d-625f-464c-aed4-287c06e0d7fe",
  "noise_threshold_nrs": 40,
  "starts_daily_at": "2025-06-20T18:29:57.000Z"
}

cURL

Python

Ruby

PHP

Seam CLI

Authentication Methods

• API key

• 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 device for which you want to create a noise threshold.

---

ends_daily_at String (Required)

Time at which the new noise threshold should become inactive daily.

---

starts_daily_at String (Required)

Time at which the new noise threshold should become active daily.

---

name String

Name of the new noise threshold.

---

noise_threshold_decibels Number

Noise level in decibels for the new noise threshold.

---

noise_threshold_nrs Number

Noise level in Noiseaware Noise Risk Score (NRS) for the new noise threshold. This parameter is only relevant for Noiseaware sensors.

---

Response

noise_threshold

JSON

{
  "device_id": "69b9e908-039b-413a-904e-5edee653ca27",
  "ends_daily_at": "09:00:00[America/Los_Angeles]",
  "name": "My Noise Threshold",
  "noise_threshold_decibels": 21,
  "noise_threshold_id": "f8cef69d-625f-464c-aed4-287c06e0d7fe",
  "noise_threshold_nrs": 5,
  "starts_daily_at": "07:00:00[America/Los_Angeles]"
}