Create alert rule

POST {{baseUrl}}/alerts/rules?aid=1234

Creates a new alert rule in your account, using the provided POST data. The Edit alert rules permission is required to create an alert rule. Note: Assigning an alert rule to a test during creation requires the Edit tests permission.

Request Params

Key	Datatype	Required	Description
`aid`	number		A unique identifier associated with your account group. You can retrieve your `AccountGroupId` from the `/account-groups` endpoint. Note that you must be assigned to the target account group. Specifying this parameter without being assigned to the target account group will result in an error response.

Request Body

{"alertType"=>"http-server", "expression"=>"((hops((hopDelay >= 100 ms))))", "roundsViolatingOutOf"=>5, "roundsViolatingRequired"=>2, "ruleName"=>"The End of the Internet", "direction"=>"to-target", "notifyOnClear"=>true, "isDefault"=>true, "minimumSources"=>10, "minimumSourcesPct"=>99, "includeCoveredPrefixes"=>true, "severity"=>"major", "notifications"=>{"email"=>{"recipients"=>["noreply@thousandeyes.com"], "message"=>"Notification message"}, "thirdParty"=>[{"integrationId"=>"sl-101", "integrationType"=>"slack"}, {"integrationId"=>"sl-101", "integrationType"=>"slack"}], "webhook"=>[{"integrationId"=>"wb-201", "integrationType"=>"webhook"}, {"integrationId"=>"wb-201", "integrationType"=>"webhook"}], "customWebhook"=>[{"integrationId"=>"cwb-201", "integrationType"=>"custom-webhook", "integrationName"=>"My webhook", "target"=>"https://example.com/test/webhooks/notifications"}, {"integrationId"=>"cwb-201", "integrationType"=>"custom-webhook", "integrationName"=>"My webhook", "target"=>"https://example.com/test/webhooks/notifications"}]}, "testIds"=>["281474976710706", "271659"]}

HEADERS

Key	Datatype	Required	Description
`Content-Type`	string
`Accept`	string

RESPONSES

status: Created

{&quot;alertType&quot;:&quot;http-server&quot;,&quot;expression&quot;:&quot;((hops((hopDelay \u003e= 100 ms))))&quot;,&quot;roundsViolatingOutOf&quot;:5,&quot;roundsViolatingRequired&quot;:2,&quot;ruleName&quot;:&quot;The End of the Internet&quot;,&quot;ruleId&quot;:&quot;127094&quot;,&quot;direction&quot;:&quot;to-target&quot;,&quot;notifyOnClear&quot;:true,&quot;isDefault&quot;:true,&quot;minimumSources&quot;:10,&quot;minimumSourcesPct&quot;:99,&quot;roundsViolatingMode&quot;:&quot;exact&quot;,&quot;includeCoveredPrefixes&quot;:true,&quot;sensitivityLevel&quot;:&quot;medium&quot;,&quot;severity&quot;:&quot;major&quot;,&quot;notifications&quot;:{&quot;email&quot;:{&quot;recipients&quot;:[&quot;noreply@thousandeyes.com&quot;],&quot;message&quot;:&quot;Notification message&quot;},&quot;thirdParty&quot;:[{&quot;integrationId&quot;:&quot;sl-101&quot;,&quot;integrationType&quot;:&quot;slack&quot;},{&quot;integrationId&quot;:&quot;sl-101&quot;,&quot;integrationType&quot;:&quot;slack&quot;}],&quot;webhook&quot;:[{&quot;integrationId&quot;:&quot;wb-201&quot;,&quot;integrationType&quot;:&quot;webhook&quot;},{&quot;integrationId&quot;:&quot;wb-201&quot;,&quot;integrationType&quot;:&quot;webhook&quot;}],&quot;customWebhook&quot;:[{&quot;integrationId&quot;:&quot;cwb-201&quot;,&quot;integrationType&quot;:&quot;custom-webhook&quot;,&quot;integrationName&quot;:&quot;My webhook&quot;,&quot;target&quot;:&quot;https://example.com/test/webhooks/notifications&quot;},{&quot;integrationId&quot;:&quot;cwb-201&quot;,&quot;integrationType&quot;:&quot;custom-webhook&quot;,&quot;integrationName&quot;:&quot;My webhook&quot;,&quot;target&quot;:&quot;https://example.com/test/webhooks/notifications&quot;}]},&quot;testIds&quot;:[&quot;281474976710706&quot;,&quot;271659&quot;],&quot;_links&quot;:{&quot;self&quot;:{&quot;href&quot;:&quot;https://api.thousandeyes.com/v7/link/to/resource/id&quot;,&quot;templated&quot;:false,&quot;type&quot;:&quot;Excepteur enim sed in&quot;,&quot;deprecation&quot;:&quot;sint Lor&quot;,&quot;name&quot;:&quot;cupidatat ullamco ipsum velit&quot;,&quot;profile&quot;:&quot;exercitation ad Lorem quis&quot;,&quot;title&quot;:&quot;dolore occaecat est ips&quot;,&quot;hreflang&quot;:&quot;irure qui eu velit dolore&quot;}}}