Create a Noise Threshold

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.

POST /noise_sensors/noise_thresholds/create

JavaScript

Seam SDK

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,
});

/*
{
  "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"
}
*/

200

{
  "action_attempt": {
    "action_attempt_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "result": {},
    "error": {
      "type": "<string>",
      "message": "<string>"
    }
  },
  "noise_threshold": {
    "device_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "ends_daily_at": "<string>",
    "name": "<string>",
    "noise_threshold_decibels": 123,
    "noise_threshold_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "starts_daily_at": "<string>",
    "noise_threshold_nrs": 123
  },
  "ok": true
}

Authorizations

api_keypat_with_workspaceconsole_session_with_workspace

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

device_id · string<uuid> · 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<float>

Noise level in decibels for the new noise threshold.

noise_threshold_nrs · number<float>

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

sync · boolean · default: false

Response

200

application/json

OK

action_attempt · object · required

Tracks the progress of this operation. Poll using the action_attempt_id.

Show child attributes

noise_threshold · object · required

Represents a 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.

Show child attributes

ok · boolean · required