{ "info": { "_postman_id": "de4cbda9-7cf2-4cec-bb4c-9c469e7a4f84", "name": "ThingsBoard Admin admin-controller notification-rule-controller API", "description": "ThingsBoard Admin API \u2014 subset of the ThingsBoard REST API (open-source IoT platform). Covers: Admin, Audit Log, Event, Usage Info, Queue, Queue Stats, Mail Config Template, Qr Code Settings, Job.\n\nContact Support:\n Name: ThingsBoard team\n Email: info@thingsboard.io", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "lastUpdatedBy": "35240", "uid": "35240-de4cbda9-7cf2-4cec-bb4c-9c469e7a4f84" }, "item": [ { "name": "api", "item": [ { "name": "notification", "item": [ { "name": "rule", "item": [ { "name": "{id}", "item": [ { "name": "Get Notification Rule by Id (getNotificationRuleById)", "id": "ea961a7c-f999-4f65-a129-835e4456fb06", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/notification/rule/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "notification", "rule", ":id" ], "variable": [ { "id": "dd02d903-1c35-4528-9d2e-65205ff62795", "key": "id", "value": "", "description": "(Required) " } ] }, "description": "Fetches notification rule info by rule's id.\nIn addition to regular notification rule fields, there are `templateName` and `deliveryMethods` in the response.\n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, "response": [ { "id": "1c04c369-996f-437d-adea-ca135b946112", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/notification/rule/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "notification", "rule", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"name\": \"\",\n \"recipientsConfig\": {\n \"escalationTable\": {\n \"mollit_b7\": [\n \"\",\n \"\"\n ],\n \"consectetur_daf\": [\n \"\",\n \"\"\n ],\n \"amet_f5\": [\n \"\",\n \"\"\n ],\n \"cupidatat_a95\": [\n \"\",\n \"\"\n ]\n },\n \"triggerType\": \"ALARM_ASSIGNMENT\"\n },\n \"templateId\": {\n \"entityType\": \"NOTIFICATION_TEMPLATE\",\n \"id\": \"\"\n },\n \"triggerConfig\": {\n \"notifyOn\": [\n \"UNASSIGNED\"\n ],\n \"triggerType\": \"DEVICE_ACTIVITY\",\n \"alarmTypes\": [\n \"\",\n \"\"\n ],\n \"alarmSeverities\": [\n \"INDETERMINATE\",\n \"MINOR\"\n ],\n \"alarmStatuses\": [\n \"ANY\",\n \"ACK\"\n ]\n },\n \"triggerType\": \"ALARM\",\n \"id\": {\n \"entityType\": \"NOTIFICATION_RULE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"enabled\": \"\",\n \"additionalConfig\": {\n \"description\": \"\"\n },\n \"templateName\": \"\",\n \"deliveryMethods\": [\n \"SMS\",\n \"SLACK\"\n ]\n}", "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-1c04c369-996f-437d-adea-ca135b946112" } ], "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-ea961a7c-f999-4f65-a129-835e4456fb06" }, { "name": "Delete Notification Rule (deleteNotificationRule)", "id": "561e0022-7ab0-4cb6-8d5c-af22d4aa73c7", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/api/notification/rule/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "notification", "rule", ":id" ], "variable": [ { "id": "a84601a0-42bf-4f08-a3e5-9268405f0693", "key": "id", "value": "", "description": "(Required) " } ] }, "description": "Deletes notification rule by id.\nCancels all related scheduled notification requests (e.g. due to escalation table)\n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, "response": [ { "id": "5f3c128a-9272-4fe9-b319-5cb1a17965e4", "name": "OK", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/api/notification/rule/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "notification", "rule", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-5f3c128a-9272-4fe9-b319-5cb1a17965e4" } ], "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-561e0022-7ab0-4cb6-8d5c-af22d4aa73c7" } ], "id": "fd0bb866-fa08-4826-9a08-112af81d35c8", "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-fd0bb866-fa08-4826-9a08-112af81d35c8" }, { "name": "Save Notification Rule (saveNotificationRule)", "id": "98913e6c-512d-48e8-b368-87c008c2deec", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"recipientsConfig\": {\n \"escalationTable\": {\n \"consectetur3_f\": [\n \"\",\n \"\"\n ]\n },\n \"triggerType\": \"EDGE_COMMUNICATION_FAILURE\"\n },\n \"templateId\": {\n \"entityType\": \"NOTIFICATION_TEMPLATE\",\n \"id\": \"\"\n },\n \"triggerConfig\": {\n \"notifyOn\": [\n \"UNASSIGNED\"\n ],\n \"triggerType\": \"TASK_PROCESSING_FAILURE\",\n \"alarmTypes\": [\n \"\",\n \"\"\n ],\n \"alarmSeverities\": [\n \"MINOR\",\n \"CRITICAL\"\n ],\n \"alarmStatuses\": [\n \"UNACK\",\n \"ANY\"\n ]\n },\n \"triggerType\": \"ALARM_ASSIGNMENT\",\n \"id\": {\n \"entityType\": \"NOTIFICATION_RULE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"enabled\": \"\",\n \"additionalConfig\": {\n \"description\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/notification/rule", "host": [ "{{baseUrl}}" ], "path": [ "api", "notification", "rule" ] }, "description": "Creates or updates notification rule. \n\nMandatory properties are `name`, `templateId` (of a template with `notificationType` matching to rule's `triggerType`), `triggerType`, `triggerConfig` and `recipientConfig`. Additionally, you may specify rule `description` inside of `additionalConfig`.\n\nTrigger type of the rule cannot be changed. Available trigger types for tenant: `ENTITY_ACTION`, `ALARM`, `ALARM_COMMENT`, `ALARM_ASSIGNMENT`, `DEVICE_ACTIVITY`, `RULE_ENGINE_COMPONENT_LIFECYCLE_EVENT`.\nFor sysadmin, there are following trigger types available: `ENTITIES_LIMIT`, `API_USAGE_LIMIT`, `NEW_PLATFORM_VERSION`.\n\nHere is an example of notification rule to send notification when a device, asset or customer is created or deleted:\n```json\n{\n \"name\": \"Entity action\",\n \"templateId\": {\n \"entityType\": \"NOTIFICATION_TEMPLATE\",\n \"id\": \"32117320-d785-11ed-a06c-21dd57dd88ca\"\n },\n \"triggerType\": \"ENTITY_ACTION\",\n \"triggerConfig\": {\n \"entityTypes\": [\n \"CUSTOMER\",\n \"DEVICE\",\n \"ASSET\"\n ],\n \"created\": true,\n \"updated\": false,\n \"deleted\": true,\n \"triggerType\": \"ENTITY_ACTION\"\n },\n \"recipientsConfig\": {\n \"targets\": [\n \"320f2930-d785-11ed-a06c-21dd57dd88ca\"\n ],\n \"triggerType\": \"ENTITY_ACTION\"\n },\n \"additionalConfig\": {\n \"description\": \"Send notification to tenant admins or customer users when a device, asset or customer is created\"\n },\n \"templateName\": \"Entity action notification\",\n \"deliveryMethods\": [\n \"WEB\"\n ]\n}\n```\n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, "response": [ { "id": "304173a1-89b4-4620-8dda-b05cee689632", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"recipientsConfig\": {\n \"escalationTable\": {\n \"consectetur3_f\": [\n \"\",\n \"\"\n ]\n },\n \"triggerType\": \"EDGE_COMMUNICATION_FAILURE\"\n },\n \"templateId\": {\n \"entityType\": \"NOTIFICATION_TEMPLATE\",\n \"id\": \"\"\n },\n \"triggerConfig\": {\n \"notifyOn\": [\n \"UNASSIGNED\"\n ],\n \"triggerType\": \"TASK_PROCESSING_FAILURE\",\n \"alarmTypes\": [\n \"\",\n \"\"\n ],\n \"alarmSeverities\": [\n \"MINOR\",\n \"CRITICAL\"\n ],\n \"alarmStatuses\": [\n \"UNACK\",\n \"ANY\"\n ]\n },\n \"triggerType\": \"ALARM_ASSIGNMENT\",\n \"id\": {\n \"entityType\": \"NOTIFICATION_RULE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"enabled\": \"\",\n \"additionalConfig\": {\n \"description\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/notification/rule", "host": [ "{{baseUrl}}" ], "path": [ "api", "notification", "rule" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"name\": \"\",\n \"recipientsConfig\": {\n \"escalationTable\": {\n \"consectetur3_f\": [\n \"\",\n \"\"\n ]\n },\n \"triggerType\": \"EDGE_COMMUNICATION_FAILURE\"\n },\n \"templateId\": {\n \"entityType\": \"NOTIFICATION_TEMPLATE\",\n \"id\": \"\"\n },\n \"triggerConfig\": {\n \"notifyOn\": [\n \"UNASSIGNED\"\n ],\n \"triggerType\": \"TASK_PROCESSING_FAILURE\",\n \"alarmTypes\": [\n \"\",\n \"\"\n ],\n \"alarmSeverities\": [\n \"MINOR\",\n \"CRITICAL\"\n ],\n \"alarmStatuses\": [\n \"UNACK\",\n \"ANY\"\n ]\n },\n \"triggerType\": \"ALARM_ASSIGNMENT\",\n \"id\": {\n \"entityType\": \"NOTIFICATION_RULE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"enabled\": \"\",\n \"additionalConfig\": {\n \"description\": \"\"\n }\n}", "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-304173a1-89b4-4620-8dda-b05cee689632" } ], "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-98913e6c-512d-48e8-b368-87c008c2deec" } ], "id": "86b1805c-d2f1-445a-b749-7ebdd2863fed", "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-86b1805c-d2f1-445a-b749-7ebdd2863fed" }, { "name": "rules", "item": [ { "name": "Get Notification Rules (getNotificationRules)", "id": "e2cf15cb-e879-414b-a1a9-da3ba2bd5dc2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/notification/rules?pageSize=&page=&textSearch=&sortProperty=&sortOrder=", "host": [ "{{baseUrl}}" ], "path": [ "api", "notification", "rules" ], "query": [ { "description": "(Required) Maximum amount of entities in a one page", "key": "pageSize", "value": "" }, { "description": "(Required) Sequence number of page starting from 0", "key": "page", "value": "" }, { "description": "Case-insensitive 'substring' filter based on rule's name", "key": "textSearch", "value": "" }, { "description": "Property of entity to sort by", "key": "sortProperty", "value": "" }, { "description": "Sort order. ASC (ASCENDING) or DESC (DESCENDING)", "key": "sortOrder", "value": "" } ] }, "description": "Returns the page of notification rules.\n\nYou can specify parameters to filter the results. The result is wrapped with PageData object that allows you to iterate over result set using pagination. See response schema for more details. \n\nAvailable for users with 'SYS_ADMIN' or 'TENANT_ADMIN' authority." }, "response": [ { "id": "94feb744-1408-4bb2-b8c5-a428616556b4", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/notification/rules?pageSize=&page=&textSearch=&sortProperty=&sortOrder=", "host": [ "{{baseUrl}}" ], "path": [ "api", "notification", "rules" ], "query": [ { "description": "(Required) Maximum amount of entities in a one page", "key": "pageSize", "value": "" }, { "description": "(Required) Sequence number of page starting from 0", "key": "page", "value": "" }, { "description": "Case-insensitive 'substring' filter based on rule's name", "key": "textSearch", "value": "" }, { "description": "Property of entity to sort by", "key": "sortProperty", "value": "" }, { "description": "Sort order. ASC (ASCENDING) or DESC (DESCENDING)", "key": "sortOrder", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": [\n {\n \"name\": \"\",\n \"recipientsConfig\": {\n \"escalationTable\": {\n \"Loremf\": [\n \"\",\n \"\"\n ],\n \"fugiatee1\": [\n \"\",\n \"\"\n ],\n \"elitd\": [\n \"\",\n \"\"\n ],\n \"sunt_9\": [\n \"\",\n \"\"\n ]\n },\n \"triggerType\": \"RATE_LIMITS\"\n },\n \"templateId\": {\n \"entityType\": \"NOTIFICATION_TEMPLATE\",\n \"id\": \"\"\n },\n \"triggerConfig\": {\n \"notifyOn\": [\n \"ASSIGNED\"\n ],\n \"triggerType\": \"NEW_PLATFORM_VERSION\",\n \"alarmTypes\": [\n \"\",\n \"\"\n ],\n \"alarmSeverities\": [\n \"WARNING\",\n \"WARNING\"\n ],\n \"alarmStatuses\": [\n \"ANY\",\n \"ANY\"\n ]\n },\n \"triggerType\": \"API_USAGE_LIMIT\",\n \"id\": {\n \"entityType\": \"NOTIFICATION_RULE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"enabled\": \"\",\n \"additionalConfig\": {\n \"description\": \"\"\n },\n \"templateName\": \"\",\n \"deliveryMethods\": [\n \"MICROSOFT_TEAMS\",\n \"EMAIL\"\n ]\n },\n {\n \"name\": \"\",\n \"recipientsConfig\": {\n \"escalationTable\": {\n \"magna_6\": [\n \"\",\n \"\"\n ],\n \"exercitation8\": [\n \"\",\n \"\"\n ]\n },\n \"triggerType\": \"RESOURCES_SHORTAGE\"\n },\n \"templateId\": {\n \"entityType\": \"NOTIFICATION_TEMPLATE\",\n \"id\": \"\"\n },\n \"triggerConfig\": {\n \"notifyOn\": [\n \"UNASSIGNED\"\n ],\n \"triggerType\": \"TASK_PROCESSING_FAILURE\",\n \"alarmTypes\": [\n \"\",\n \"\"\n ],\n \"alarmSeverities\": [\n \"MINOR\",\n \"MAJOR\"\n ],\n \"alarmStatuses\": [\n \"ACTIVE\",\n \"ANY\"\n ]\n },\n \"triggerType\": \"API_USAGE_LIMIT\",\n \"id\": {\n \"entityType\": \"NOTIFICATION_RULE\",\n \"id\": \"\"\n },\n \"createdTime\": \"\",\n \"tenantId\": {\n \"entityType\": \"TENANT\",\n \"id\": \"\"\n },\n \"enabled\": \"\",\n \"additionalConfig\": {\n \"description\": \"\"\n },\n \"templateName\": \"\",\n \"deliveryMethods\": [\n \"WEB\",\n \"SMS\"\n ]\n }\n ],\n \"totalPages\": \"\",\n \"totalElements\": \"\",\n \"hasNext\": \"\"\n}", "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-94feb744-1408-4bb2-b8c5-a428616556b4" } ], "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-e2cf15cb-e879-414b-a1a9-da3ba2bd5dc2" } ], "id": "5a4d3d09-5c11-453c-98d3-2f081eb4011d", "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-5a4d3d09-5c11-453c-98d3-2f081eb4011d" } ], "id": "a508cb23-77b0-4578-a1a8-aaccfa4dfe06", "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-a508cb23-77b0-4578-a1a8-aaccfa4dfe06" } ], "id": "b9c4784c-d194-4b68-a62e-8e4e406f6f89", "createdAt": "2026-07-28T03:12:55.000Z", "updatedAt": "2026-07-28T03:12:55.000Z", "uid": "35240-b9c4784c-d194-4b68-a62e-8e4e406f6f89" } ], "variable": [ { "key": "baseUrl", "value": "https://demo.thingsboard.io" } ] }