> ## Documentation Index > Fetch the complete documentation index at: https://docs.seam.co/llms.txt > Use this file to discover all available pages before exploring further. # Create a Noise Threshold > Creates a new [noise threshold](https://docs.seam.co/capability-guides/noise-sensors/configure-noise-threshold-settings) for a [noise sensor](https://docs.seam.co/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. ## OpenAPI ````yaml /openapi.json post /noise_sensors/noise_thresholds/create openapi: 3.0.0 info: title: Seam Connect version: 1.0.0 servers: - url: https://connect.getseam.com security: [] tags: - description: access_codes name: /access_codes - description: acs name: /acs - description: action_attempts name: /action_attempts - description: client_sessions name: /client_sessions - description: connected_accounts name: /connected_accounts - description: connect_webviews name: /connect_webviews - description: devices name: /devices - description: events name: /events - description: health name: /health - description: locks name: /locks - description: networks name: /networks - description: noise_sensors name: /noise_sensors - description: phones name: /phones - description: thermostats name: /thermostats - description: user_identities name: /user_identities - description: webhooks name: /webhooks - description: workspaces name: /workspaces paths: /noise_sensors/noise_thresholds/create: post: tags: - /noise_sensors summary: Create a Noise Threshold description: >- Creates a new [noise threshold](https://docs.seam.co/capability-guides/noise-sensors/configure-noise-threshold-settings) for a [noise sensor](https://docs.seam.co/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. operationId: noiseSensorsNoiseThresholdsCreatePost requestBody: content: application/json: schema: properties: device_id: description: >- ID of the device for which you want to create a noise threshold. format: uuid type: string ends_daily_at: description: >- Time at which the new noise threshold should become inactive daily. type: string name: description: Name of the new noise threshold. type: string noise_threshold_decibels: description: Noise level in decibels for the new noise threshold. format: float type: number noise_threshold_nrs: description: >- Noise level in Noiseaware Noise Risk Score (NRS) for the new noise threshold. This parameter is only relevant for [Noiseaware sensors](https://docs.seam.co/device-and-system-integration-guides/noiseaware-sensors). format: float type: number starts_daily_at: description: >- Time at which the new noise threshold should become active daily. type: string sync: default: false type: boolean x-undocumented: Only used internally. required: - device_id - starts_daily_at - ends_daily_at type: object responses: '200': content: application/json: schema: properties: action_attempt: type: object description: >- Tracks the progress of this operation. Poll using the action_attempt_id. properties: action_attempt_id: type: string format: uuid description: ID of the action attempt. action_type: type: string enum: - CREATE_NOISE_THRESHOLD description: Type of action being tracked. status: type: string enum: - pending - success - error description: Current status of the action. result: type: object nullable: true description: Result payload on success. error: type: object nullable: true description: Error details on failure. properties: type: type: string message: type: string required: - action_attempt_id - action_type - status noise_threshold: $ref: '#/components/schemas/noise_threshold' ok: type: boolean required: - action_attempt - noise_threshold - ok type: object description: OK '400': description: Bad Request '401': description: Unauthorized security: - api_key: [] - pat_with_workspace: [] - console_session_with_workspace: [] x-codeSamples: - lang: javascript label: Seam SDK source: |- 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" } */ - lang: bash label: cURL source: >- curl --include --request POST "https://connect.getseam.com/noise_sensors/noise_thresholds/create" \ --header "Authorization: Bearer $SEAM_API_KEY" \ --json @- < { "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", } - lang: php label: Seam SDK source: |- $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, ); // [ "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", ]; - lang: bash label: Seam CLI source: >- 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 # { # "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" # } components: schemas: noise_threshold: description: >- Represents a [noise threshold](https://docs.seam.co/capability-guides/noise-sensors/configure-noise-threshold-settings) for a [noise sensor](https://docs.seam.co/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. properties: device_id: description: Unique identifier for the device that contains the noise threshold. format: uuid type: string ends_daily_at: description: Time at which the noise threshold should become inactive daily. type: string name: description: Name of the noise threshold. type: string noise_threshold_decibels: description: Noise level in decibels for the noise threshold. format: float type: number noise_threshold_id: description: Unique identifier for the noise threshold. format: uuid type: string noise_threshold_nrs: description: >- Noise level in Noiseaware Noise Risk Score (NRS) for the noise threshold. This parameter is only relevant for [Noiseaware sensors](https://docs.seam.co/device-and-system-integration-guides/noiseaware-sensors). format: float type: number starts_daily_at: description: Time at which the noise threshold should become active daily. type: string required: - noise_threshold_id - device_id - name - starts_daily_at - ends_daily_at - noise_threshold_decibels type: object x-route-path: /noise_sensors/noise_thresholds securitySchemes: api_key: bearerFormat: API Key scheme: bearer type: http pat_with_workspace: bearerFormat: API Token scheme: bearer type: http console_session_with_workspace: bearerFormat: Console Session Token scheme: bearer type: http ````