---
title: "Create a Noise Threshold"
method: POST
path: "/noise_sensors/noise_thresholds/create"
tags: ["/noise_sensors"]
---

# Create a Noise Threshold

`POST /noise_sensors/noise_thresholds/create`

## Request

- Base URL: `https://connect.getseam.com`
- URL: `https://connect.getseam.com/noise_sensors/noise_thresholds/create`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
- TypeScript: <https://skmtc.dev/seam/apis/seam-connect/docs/noise_sensors/noise_thresholds/create/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new [noise threshold](/capability-guides/noise-sensors/configure-noise-threshold-settings) for a [noise sensor](/capability-guides/noise-sensors). 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.

## Request body

- object
  - `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.
  - `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](/device-and-system-integration-guides/noiseaware-sensors).
  - `starts_daily_at` string, required: Time at which the new noise threshold should become active daily.

## Response `200`

OK

- object
  - `noise_threshold` NoiseThreshold, required: Represents a [noise threshold](/capability-guides/noise-sensors/configure-noise-threshold-settings) for a [noise sensor](/capability-guides/noise-sensors). 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. See the [noise_threshold object](/api/noise_sensors/noise_thresholds/object).
    - `device_id` string, uuid, required: Unique identifier for the device that contains the noise threshold.
    - `ends_daily_at` string, required: Time at which the noise threshold should become inactive daily.
    - `name` string, required: Name of the noise threshold.
    - `noise_threshold_decibels` number, float, required: Noise level in decibels for the noise threshold.
    - `noise_threshold_id` string, uuid, required: Unique identifier for the noise threshold.
    - `noise_threshold_nrs` number, float: Noise level in Noiseaware Noise Risk Score (NRS) for the noise threshold. This parameter is only relevant for [Noiseaware sensors](/device-and-system-integration-guides/noiseaware-sensors).
    - `starts_daily_at` string, required: Time at which the noise threshold should become active daily.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/seam/apis/seam-connect.md) - [All operations](https://skmtc.dev/seam/apis/seam-connect/llms.txt) - [OpenAPI document](https://skmtc.dev/seam/apis/seam-connect/revisions/00c35395ce12?raw)