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

Creates a new noise threshold for a noise sensor.

Code:

curl --include --request POST "https://connect.getseam.com/noise_sensors/noise_thresholds/create" \
  --header "Authorization: Bearer $SEAM_API_KEY" \
  --json @- <<EOF
{
  "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
}
EOF

Output:

{
  "noise_threshold": {
    "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"
  }
}

Python

Creates a new noise threshold for a noise sensor.

Code:

seam.noise_sensors.noise_thresholds.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:

NoiseThreshold(
    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",
)

Ruby

Creates a new noise threshold for a noise sensor.

Code:

seam.noise_sensors.noise_thresholds.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",
}

PHP

Creates a new noise threshold for a noise sensor.

Code:

$seam->noise_sensors->noise_thresholds->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",
];

Seam CLI

Creates a new noise threshold for a noise sensor.

Code:

seam noise-sensors noise-thresholds 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"
}

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]"
}